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 完全忽略：

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

"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 版本”。