使用 --ignore-platform-req=ext-redis 可精确跳过指定扩展检查，多个需重复参数；--ignore-platform-reqs 则全量忽略且不支持指定项；推荐用 config.platform 在 composer.json 中统一声明虚拟平台环境。
composer install 时跳过某个 PHP 扩展检查
想让 composer install 忽略 ext-redis 这类扩展依赖，但又不想关掉全部平台检查，直接加 --ignore-platform-req=ext-redis 就行。
这个参数不是全局开关，而是精确到具体扩展或 PHP 版本名。常见写法包括：--ignore-platform-req=php、--ignore-platform-req=ext-gd、--ignore-platform-req=ext-mbstring。
- 多个要忽略的项，得重复写多次：
--ignore-platform-req=ext-redis --ignore-platform-req=ext-zip - 不能写成通配符形式，比如
--ignore-platform-req="ext-*"会报错 - 它只影响当前命令执行，不改变
composer.json或锁文件内容 - 如果该扩展实际缺失，运行时仍可能出错——这只是绕过 Composer 的安装校验，不是解决依赖问题
为什么 --ignore-platform-reqs（带 s）不能局部生效
--ignore-platform-reqs 是全量忽略，和 --ignore-platform-req（无 s）是两个不同参数。前者没有“指定忽略谁”的能力，后者才支持单个项。
容易混淆的点在于：拼写差一个字母，行为天壤之别。
-
--ignore-platform-reqs→ 忽略所有平台要求（PHP 版本、扩展、INI 设置） -
--ignore-platform-req=ext-xml→ 只跳过 ext-xml 检查，其余照常校验 - 输错成
--ignore-platform-reqs=ext-xml，Composer 会直接报错：“Unrecognized option 'ignore-platform-reqs'”
CI/CD 中用 --ignore-platform-req 要小心环境一致性
在 GitHub Actions 或 GitLab CI 里临时跳过某个扩展，是为了让构建通过，但这可能掩盖真实环境差异。
比如你在本地开发用 PHP 8.2 + redis，CI 用的是 PHP 8.1 且没装 redis 扩展，加了 --ignore-platform-req=ext-redis 后 install 成功，但后续测试或运行时一调用 new Redis() 就报 Class 'Redis' not found。
- 建议只在明确知道该扩展非运行必需（比如仅用于 dev 依赖中的某工具）时使用
- 生产部署绝对不要依赖这个参数，应统一基础镜像或扩展安装逻辑
- 若只是测试阶段需要，可配合
composer install --no-scripts避免触发需扩展的 post-install 脚本
替代方案：用 platform 配置伪造环境
比起每次命令加参数，更稳妥的做法是在 composer.json 里用 config.platform 声明“假装有”某个扩展。
例如：
"config": {
"platform": {
"php": "8.1.0",
"ext-redis": "5.3.7"
}
}
这样所有 Composer 命令都按这个“虚拟平台”做依赖解析，不用反复敲参数，也避免漏写。
- 适用于团队协作或标准化构建流程
- 注意版本号要写对，否则可能因版本约束不匹配导致装错包
- 它不影响实际运行环境，只是告诉 Composer “我有这个”，所以仍需确保运行时真有或有替代实现
真正麻烦的从来不是怎么跳过检查，而是跳过后没人再关心那个被跳过的扩展到底有没有、能不能用。
