Composer中文开发者避坑指南：深度解析Platform伪装配置-composer-PHP中文网

config.platform 不能让 composer install 按旧版 php 装包，必须配合 --platform=php:x.x.x 或重生成 composer.lock 才生效；因其仅在 composer update 时参与依赖解析，而 install 仅校验 composer.lock 和本地真实环境，不读取 config.platform 配置。

composer中文开发者避坑指南：深度解析platform伪装配置

config.platform 不能让 composer install 按旧版 PHP 装包，必须配合 --platform=php:x.x.x 或重生成 composer.lock 才生效。

为什么改了 config.platform 还是装不了 PHP 7.4 的包？

因为 composer install 默认不解析依赖，它只读 composer.lock 并校验本地真实环境。而 config.platform 只在 composer update 阶段参与依赖解析——锁文件里存的是上次 update 时的结果，跟你刚写的 platform 配置无关。

常见现象：composer.json 里写了 "config": { "platform": { "php": "7.4.33" } }，但 composer install 仍报错 Your PHP version (8.2.10) does not satisfy that requirement
根本原因：锁文件里记录的包（比如 monolog/monolog:^3.0）要求 php: ^8.0，而 Composer 安装时只检查你本地是不是真有 8.0+，根本不看 config.platform
验证方式：删掉 vendor/ 和 composer.lock，再跑 composer update，然后看新 composer.lock 里选的包是否降级到了 PHP 7.4 兼容版本

怎么让 composer install 强制按 PHP 7.4 解析并安装？

唯一可靠的方式是用 --platform 参数覆盖本次命令的平台信息。它在 install 和 update 两个阶段都生效，且优先级高于 config.platform。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

正确写法：composer install --platform=php:7.4.33（必须带完整补丁号，7.4 或 ^7.4 会被忽略）
扩展也要显式声明：--platform=ext-mbstring:7.4.33 --platform=ext-openssl:7.4.33，否则遇到 require: "ext-mbstring": "*" 的包仍会失败
注意前缀：--platform=gd:1.0 无效，必须是 --platform=ext-gd:1.0
多个 --platform 可叠加，重复指定以最后出现的为准

config.platform 写在哪、怎么写才不被忽略？

它必须严格写在项目根目录 composer.json 的 "config" 对象内，键名是 "platform"，值是一个对象——写错位置或格式，Composer 会静默跳过。

正确结构：

{
  "require": {},
  "config": {
    "platform": {
      "php": "7.4.33",
      "ext-mbstring": "7.4.33",
      "ext-openssl": "7.4.33"
    }
  }
}

错误写法："config.platform": { }（不存在这个字段）、"platform": { }（不在 config 下）、"platform": "7.4"（不是对象，版本不是字符串）
验证是否生效：composer config --list | grep platform，看到带 (local) 标记的输出才算对

platform 伪装后，代码真能在 PHP 7.4 下跑起来吗？

不能保证。platform 只影响依赖版本选择，不改变实际运行环境，也不阻止语法或函数调用层面的兼容性问题。

platform 不会把 match 表达式变成 PHP 7.4 支持的写法，也不会让 str_contains() 在 7.4 中可用
它不校验扩展是否真实加载，只看你有没有在 platform 里声明；没列的扩展，Composer 就当它不可用
如果项目 require 里写了 "php": "^8.1"，那 platform 设成 "8.0.0" 会导致 composer update 报错——约束冲突优先于伪装

真正容易被忽略的是：哪怕 --platform 让依赖装上了，只要代码里用了 PHP 8.0+ 特性，运行时照样崩。伪装只解决“装得上”，不解决“跑得动”。