应优先使用--ignore-platform-req=ext-xxx精准跳过单个扩展检查，而非危险的--ignore-platform-reqs全局跳过；后者会忽略php版本、所有扩展及系统库，易导致运行时崩溃。
直接用 --ignore-platform-req=ext-xxx，别用 --ignore-platform-reqs 全局跳过——除非你真想同时忽略 PHP 版本、所有扩展和系统库。
只跳过某个扩展（比如 ext-gd）的检查
这是最常被误用的场景。报错里写着 The requested PHP extension ext-gd * is missing from your system，但你其实装了、只是没启用，或版本号不匹配（如系统是 gd 8.2.0，而依赖要求 "ext-gd": "^8.1" 但实际检测到 8.2.0RC）。这时该用精准参数：
-
--ignore-platform-req=ext-gd：只跳过 gd 扩展校验，PHP 版本和其他扩展照常检查 - 多个扩展要分开写：
--ignore-platform-req=ext-gd --ignore-platform-req=ext-mbstring，不能合并成逗号分隔 - 键名必须严格匹配 composer.json 或依赖包中声明的名称，
ext-redis不能简写为redis，大小写敏感 - 这个参数对
composer install、update、require、create-project都有效
为什么 --ignore-platform-reqs 很危险
它不是“跳过扩展”，而是跳过全部平台约束：PHP 版本、所有 ext-*、lib-*、甚至架构（如 php-64bit）。常见后果：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 在 PHP 7.4 上用
--ignore-platform-reqs装了只支持 PHP 8.2+ 的包，install 成功，运行时直接ParseError - 跳过了
ext-swoole检查，但项目启动后立刻报Class 'Swoole\Http\Server' not found - CI 中用了它，测试通过，上线才发现生产环境缺
ext-pdo_pgsql，连数据库都连不上 - 它不会改
composer.lock，但锁文件里可能记录了根本跑不动的版本组合
临时绕过 vs 永久配置：什么时候该动 composer.json
如果团队多人、CI/CD 固定用某套 PHP 环境（比如 Docker 镜像固定为 PHP 8.2.10 + ext-gd 8.2.0），可以在 composer.json 里加 config.platform 做声明式覆盖：
{
"config": {
"platform": {
"php": "8.2.10",
"ext-gd": "8.2.0",
"ext-redis": "5.3.7"
}
}
}
注意：
- 这会让所有命令（install/update/create-project）都按这个“虚拟平台”解析依赖，不读真实环境
- 它不解决运行时缺失问题，只是让 Composer “信你有”
- 上线前必须在真实目标环境中验证——尤其是
ext-sodium这类编译时可开关的扩展，php -m | grep sodium得真有 - 不要在开发机上长期用这个配置掩盖本地环境问题；它更适合构建镜像或 CI 流水线统一环境
真正难的从来不是怎么跳过检查，而是跳过之后没人去确认 php -v 和 php -m 输出是否真满足运行时需要——尤其当错误只在特定请求路径下才触发时。
