应使用--ignore-platform-req=ext-xxx精准跳过单个扩展（如ext-redis），参数须严格匹配composer.json中require键名、大小写敏感且不可省略ext-前缀；忽略多个需重复书写该参数，而非逗号分隔。
直接用 --ignore-platform-req=ext-xxx，比如跳过 ext-redis 就写 --ignore-platform-req=ext-redis。这不是“关闭检查”，而是告诉 Composer：“这个扩展我不管它存不存在，你别拦着装包”。
怎么精准忽略单个扩展（不是 PHP 版本）
参数值必须严格匹配 composer.json 中 require 里写的键名，大小写敏感，不能省略 ext- 前缀：
-
composer install --ignore-platform-req=ext-gd—— 只跳过 GD 扩展检查 -
composer require monolog/monolog --ignore-platform-req=ext-amqp—— 安装时绕过 AMQP 扩展要求 - 要忽略多个？重复写参数：
--ignore-platform-req=ext-redis --ignore-platform-req=ext-curl - 错误写法：
--ignore-platform-req=redis（缺ext-）、--ignore-platform-req=php（这是跳 PHP 版本，不是扩展）
为什么加了参数还是报错？常见漏点
加了 --ignore-platform-req=ext-xxx 却仍失败，大概率是以下原因：
- 错误信息里其实不是
ext-xxx缺失，而是别的扩展或lib-xxx（比如lib-xml）没满足，得看完整报错再加对应参数 -
composer.json的require里写了"ext-redis": "*"，但实际项目还通过其他依赖间接要求了ext-swoole，而你没忽略它 - 用了
composer update—— 它会重新解析整棵树，比install更容易触发平台约束冲突；优先用install+ 锁文件 - CI 脚本里加了参数，但后续执行的
php artisan config:clear或phpunit等命令运行时真调用了扩展，这时才爆Class 'Redis' not found
比命令行更稳定的长期方案：platform 配置
如果经常要在某环境（如 CI、Docker 构建）跳过某些扩展，不建议每次敲长命令，改用 config.platform 声明“已存在”：
立即学习“PHP免费学习笔记（深入）”；
"config": {
"platform": {
"ext-redis": "5.3.7",
"ext-gd": "8.1.0"
}
}
这样 composer install 和 composer update 都自动按此“伪造环境”解析，且只影响当前项目。注意：
- 版本号填什么不重要，只要不是空字符串，Composer 就认为该扩展“已安装”
- 这个配置不会让 PHP 真加载扩展，也不会改
php.ini，纯属骗过依赖解析器 - 上线前务必确认生产环境真实启用了这些扩展，否则服务启动时才会暴露问题，堆栈远不如 Composer 报错清晰
最易被忽略的一点：忽略扩展检查 ≠ 项目能跑。你绕过了 Composer 的门禁，不代表 PHP 运行时不会在第一行 new Redis() 就给你关灯。尤其框架的服务提供者、缓存驱动、日志通道，往往在容器初始化阶段就硬依赖扩展，此时才真正失败。
