Composer 的 config 字段不支持 platform 配置，真正控制平台模拟的是与 require 同级的顶层 platform 字段；config.platform 无效且被完全忽略，仅 platform 能锁定 PHP/扩展版本以确保跨环境依赖一致性。
Composer 项目中，config 字段本身**不用于声明系统平台要求**（如 PHP 版本、扩展依赖等），那是 platform 和 require 的职责。误把配置写在 config 下会导致平台约束完全失效。
platform 配置才是控制“模拟系统环境”的关键
当你在 CI/CD 或低版本服务器上部署时，需要让 Composer 安装与目标环境一致的依赖版本（比如线上是 PHP 7.4，但本地是 PHP 8.2），就必须用 platform 显式锁定平台能力：
-
platform是根级字段，和require同级，不是config的子项 - 它只影响依赖解析过程，不改变运行时行为
- 常见写法：
{ "require": { "php": "^7.4 || ^8.0", "ext-json": "*" }, "platform": { "php": "7.4.33", "ext-gd": "8.0.0" } } - 如果
platform中指定了php，Composer 就会忽略你本地实际的 PHP 版本，按该值筛选兼容的包版本
config.platform 会覆盖 platform 字段？不会，它根本不存在
config 下没有 platform 这个键。以下写法是无效的，会被 Composer 完全忽略：
"config": {
"platform": {
"php": "8.1.0"
}
}
这种错误常出现在复制粘贴或混淆了旧版文档。Composer 的 config 只管理自身行为，例如：
-
config.allow-plugins：控制哪些插件可被启用 -
config.sort-packages：自动按字母序排列require项 -
config.process-timeout：设置脚本执行超时（单位秒） -
config.cache-dir：指定全局缓存路径（非项目级）
为什么 config.platform 看起来像能用？其实是历史遗留误解
早期（v1.x）有极少数第三方插件尝试读取 config.platform，但官方从未支持。Composer v2+ 已彻底移除任何对 config.platform 的解析逻辑。验证方式很简单：
- 在
composer.json中写入"config": {"platform": {"php": "5.6.0"}} - 运行
composer show php—— 显示的仍是本地真实 PHP 版本 - 运行
composer install并检查vendor/composer/installed.json，你会发现安装的包版本仍基于你本地 PHP，而非config.platform声明的
真正起作用的只有顶层 platform，且它必须与 require 中的约束逻辑自洽。漏掉 require.php 而只写 platform.php，可能导致意外安装高版本包——因为 Composer 缺少锚点来判断“最低兼容 PHP 版本”。
