composer 的 platform 配置项用于强制声明目标环境的 php 及扩展版本，使依赖解析按生产环境而非本地环境进行，解决开发与生产不一致问题；它仅影响 install/update 决策，不改变实际运行，常配合 platform-check false 用于 ci/cd。
Composer 的 platform 配置项用于**强制声明当前运行环境所“具备”的 PHP 及扩展版本**，让 Composer 在依赖解析时，**假装这些版本已安装在目标系统上**，即使本地实际环境不同。它最常用于模拟生产环境，避免因开发机 PHP 版本或扩展缺失导致依赖安装失败或选错版本。
解决“开发环境 vs 生产环境”不一致问题
比如生产服务器用的是 PHP 8.1 + ext-gd 8.1，而你本地是 PHP 8.2 且没装 gd 扩展。Composer 默认按本地环境解析依赖，可能选错包版本（如选了要求 php: ^8.2 的 dev-only 包），或直接报错“gd extension not found”。platform 就是用来告诉 Composer：“请按 PHP 8.1 和有 gd 8.1 的环境来算依赖”。
- 配置写在
composer.json的config段中 - 支持覆盖
php、php-extension（如ext-gd、ext-mbstring）、lib-*（如lib-iconv）等 - 不影响实际运行，只影响
install/update时的依赖决策
典型 platform 配置示例
对应常见生产环境（PHP 8.1 + 基础扩展）：
"config": {
"platform": {
"php": "8.1.28",
"ext-gd": "8.1.28",
"ext-mbstring": "8.1.28",
"ext-xml": "8.1.28",
"ext-curl": "8.1.28",
"ext-json": "8.1.28"
}
}注意：ext-* 的版本号一般填 0 或与 PHP 版本一致即可（Composer 不校验扩展真实版本，只看是否“存在”）；填 0 更稳妥，例如 "ext-gd": "0" 表示“只要装了 gd，版本不限”。
和 platform-check 的区别
platform 是“声明我有”，而 config.platform-check（默认 true）是“检查我真有”。如果你设置了 platform 但本地缺对应扩展，Composer install 时仍会警告（如 The requested PHP extension gd is missing from your system）。要跳过这个检查，可加：
"config": {
"platform-check": false,
"platform": { ... }
}⚠️ 跳过检查仅建议在 CI/CD 或容器化构建中使用，日常开发建议保留检查，早发现问题。
CI/CD 和 Docker 构建中的实用技巧
在 GitHub Actions 或 GitLab CI 中，常配合 platform 使用：
- 用
composer install --no-dev --optimize-autoloader+ platform，确保生成的vendor/autoload.php和composer.lock与生产完全一致 - Dockerfile 中可在
composer install前临时覆盖 platform（通过-d platform.php=8.1），避免为构建镜像安装额外扩展 - 团队应把
platform提交进composer.json，作为“生产环境契约”的一部分
