config.platform仅在composer update时影响依赖解析，install时仍校验本地真实环境；需用--platform参数强制覆盖install阶段平台信息，如--platform=php:8.2.10。
直接改 config.platform 不足以让 composer install 按目标环境解析依赖——它只在 update 阶段影响包选择，install 时仍会校验本地真实 PHP 和扩展版本，导致失败或装错包。
为什么 config.platform.php 在 install 时不起作用
config.platform.php 是静态声明，仅用于 composer update 生成 composer.lock 时的依赖解析逻辑。一旦 lock 文件已存在，composer install 就跳过解析，直接按 lock 中记录的包安装，并用当前真实环境做平台校验。所以即使你写了 "platform": {"php": "8.2.10"}，只要本地是 PHP 8.0，install 仍会报 Your PHP version does not satisfy that requirement。
- 常见误操作：CI 脚本里只改了
composer.json的 platform，却没在install命令中显式覆盖 - 后果：低版本 PHP 环境成功 install，但运行时因语法（如
match）或扩展缺失直接 fatal error - 验证方式：运行
php -v和php -m | grep gd，确认真实环境能力是否匹配 lock 文件所依赖的包要求
用 --platform 参数强制覆盖 install 阶段平台信息
--platform 是唯一能在 install 和 update 两个阶段都生效、且优先级高于 config.platform 的方式。它直接注入平台包元数据，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:8.2.10 --platform=ext-gd:8.2.10 --platform=ext-redis:5.3.7 - 必须带
ext-前缀，--platform=gd:1.0无效 - 扩展版本不能省略，
--platform=ext-mbstring会被视为“存在但版本未知”，仍可能触发严格约束失败 - 多个
--platform可叠加，顺序无关；重复指定同一项（如两次--platform=php:8.1）以后出现的为准
CI/CD 中如何安全绕过平台校验
CI 环境通常 PHP 版本固定但扩展不全（比如缺 ext-zip），而项目又依赖高版本扩展约束。此时不应盲目加 --ignore-platform-reqs，而是分层处理：
- 只跳过 PHP 版本检查：
composer install --ignore-platform-req=php—— 保留对ext-*的校验，避免漏装关键扩展 - 跳过特定扩展：
composer install --ignore-platform-req=ext-zip，比全关更精准 -
--ignore-platform-reqs仅限调试或临时构建镜像，上线前必须移除；它不会修改 lock 文件，但会掩盖真实兼容性风险 - CI 脚本开头务必加
php -v && php -m日志，否则无法区分是配置问题还是环境缺失
容易被忽略的关键点
很多人以为设了 platform 就万事大吉，其实最常踩的坑藏在细节里：
-
config.platform提交进 Git 后，队友本地 PHP 版本不同，composer update会按伪装版本选包，但composer install在他们机器上仍可能失败——这不是 bug，是机制设计使然 -
--platform=php:8.2.0不代表你能跑readonly或enum，它只骗过 Composer 的依赖解析器，不改变 PHP 解释器能力 - Docker 构建中，
RUN composer install命令若没显式指定--platform，就完全依赖基础镜像的 PHP 版本和扩展，极易出错 - 别用
"platform": {"php": null}或空字符串试图“清空”伪装——Composer 会静默忽略或报错，null不是合法值
