应优先使用--ignore-platform-req=php等精准参数跳过指定检查，而非--ignore-platform-reqs全局跳过或config.platform伪装环境；后者会改变依赖解析结果，前者仅绕过校验且语义清晰、风险可控。
直接用 --ignore-platform-reqs 或更精准的 --ignore-platform-req=xxx，别改 config.platform 来“伪装”环境——后者会影响依赖解析逻辑，而前者只跳过校验，语义更干净。
什么时候该用 --ignore-platform-reqs？
它只在安装/更新阶段起作用，适合你**确认运行时环境实际满足需求**，但被 Composer 卡在平台检查这一步的场景：
- CI 构建中 PHP 版本略低（比如本地是 8.1，lock 文件锁的是 8.2+，但你清楚代码没用 8.2 特性）
- Docker 构建阶段尚未装完扩展（如
ext-zip在composer install后才通过docker-php-ext-install补上） - 团队共用一份
composer.lock，但成员 PHP 小版本不统一（如 8.1.22 vs 8.1.30），而差异不影响运行
它不是“兼容性解决方案”，只是让安装流程继续——vendor/bin/phpunit 启动时仍可能因 PHP 版本不满足自身 require 而拒绝执行，那跟 Composer 无关。
--ignore-platform-reqs 和 --ignore-platform-req=php 区别在哪？
前者跳过全部平台检查（php、ext-gd、lib-curl 等），后者只跳过指定项。关键差异：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer install --ignore-platform-reqs：全放行，风险高，CI 中慎用 -
composer install --ignore-platform-req=php：只绕过 PHP 版本，保留扩展检查，能帮你暴露真实缺失的ext-mbstring等问题 - 可叠加使用：
--ignore-platform-req=php --ignore-platform-req=ext-gd，值必须严格匹配依赖声明（大小写敏感，ext-imagick不能写成imagick） -
--ignore-platform-reqs=true是无效写法，Composer 不识别=true
为什么别轻易往 composer.json 里加 "platform"？
"config": { "platform": { "php": "8.1.0" } } 不是“忽略”，而是“模拟”——它会改变依赖解析结果，比如让 Composer 选一个标称支持 PHP 8.1 的包版本，哪怕你本地是 7.4。后果包括：
- 装出来的包，在真实 7.4 环境下运行时报
str_contains()不存在 -
composer update可能引入只兼容 8.1 的新版本，而你根本没意识到 -
"platform": {"php": null}或空字符串会直接报错，null不是合法值 - 它不解决
vendor/bin/xxx自身的运行时校验（如 phpunit 内部检查PHP_VERSION_ID）
CI/CD 里最稳妥的写法是什么？
GitHub Actions、GitLab CI 等场景下，推荐明确指定要忽略的项，而不是无差别跳过：
composer install --ignore-platform-req=php --ignore-platform-req=ext-zip- 配合
--no-scripts避免执行需要扩展的post-install-cmd（如 Laravel 的Illuminate\Foundation\ComposerScripts::postInstall） - 不要把
--ignore-platform-reqs写死在Makefile或docker-compose.yml里——新成员 clone 即中毒，排查成本远高于临时加参数 - 如果构建镜像已固定 PHP 版本且扩展齐全，其实根本不需要这个参数；真要用，优先在 CI 脚本里显式写出忽略项，方便后续审计
真正容易被忽略的点是：这个参数对 composer.lock 无任何影响，它只是让安装流程“假装满足”——但 vendor 里的代码是否真能跑，还得看 PHP 版本、扩展、甚至 lib 库有没有在运行时被加载。
