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，作为“生产环境契约”的一部分