--ignore-platform-reqs仅跳过PHP版本、PHP扩展（如ext-gd）、系统库（如lib-curl）三类平台校验，不修改依赖版本约束、不改动composer.lock、不影响依赖解析逻辑，但运行时仍可能因缺失扩展或语法不兼容崩溃。
composer install --ignore-platform-reqs到底跳过什么
它只跳过三类平台级校验：本地 PHP 版本（php -v 与 "php": "^8.2" 是否匹配）、已启用的 PHP 扩展（如 ext-gd、ext-redis）、系统库（如 lib-curl）。不碰任何包版本约束，不改 composer.lock，也不影响依赖解析逻辑。
常见错误现象：Required platform packages not satisfied: php ^8.2, ext-redis * —— 这不是网络或权限问题，是 Composer 主动中止安装，防止你掉进运行时坑里。
-
--ignore-platform-reqs是完整参数名，--ignore-platform-req（少 s）会报错 - 值必须严格匹配声明名，
ext-imagick不能写成imagick或EXT-IMAGICK - 该参数对
composer require、composer update、composer create-project同样生效
为什么加了--ignore-platform-reqs还是运行时报错
因为这个参数只让 install 过去，不解决运行时依赖。装完仍可能崩在第一行代码上。
典型场景：
- 用了
--ignore-platform-reqs装了 Laravel Octane，但没装ext-swoole→ 启动时Class 'Swoole\Http\Server' not found - 项目要求
"php": "^8.2"，你在 PHP 8.0 下强行装 → 遇到str_starts_with()或match表达式直接报语法错误 - CI 构建机缺
ext-pdo_sqlite，用参数跳过安装，但测试脚本一连 SQLite 就Class 'PDO' not found
关键点：它不安装扩展、不降级 PHP、不重写 autoload、也不绕过 opcache 缓存的兼容性检查。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
怎么精准跳过，而不是一刀切
全关 --ignore-platform-reqs 风险高，尤其在团队协作中容易掩盖真实环境差异。推荐用 --ignore-platform-req=xxx 精准控制。
- 只跳 PHP 版本检查：
composer install --ignore-platform-req=php - 只跳某个扩展：
composer install --ignore-platform-req=ext-gd - 跳多个项可叠加：
composer install --ignore-platform-req=php --ignore-platform-req=ext-mbstring - 注意：
--ignore-platform-reqs=true是无效写法，Composer 会直接拒绝执行
这种写法从 Composer 2.2 起支持，且只作用于当前命令，不会污染 composer.json 或锁文件。
替代方案：比命令行参数更稳妥的做法
如果频繁需要绕过平台检查，说明环境和项目声明长期不一致，命令行参数只是临时补丁。
更可持续的解法：
- 在
composer.json的config段加"platform-check": false（Composer 2.2+），实现项目级关闭 - 用
"config": {"platform": {"php": "8.1.0"}}显式声明“假装”有某个版本，适合 Docker 构建中统一环境语义 - CI 中优先升级 PHP 或安装缺失扩展，而非跳过检查；本地开发则建议用 Valet / Docker 匹配生产环境
真正麻烦的从来不是装不上，而是装上了却在某个深夜部署后，因为少一个 ext-igbinary 导致队列消费卡死——而日志里只有一行 Class not found。
