composer install 因缺失扩展报错是因它默认检查 require 和 config.platform.php 中声明的扩展是否已加载，如 ext-redis 未安装则中断以提前暴露运行时风险；可临时用 --ignore-platform-req=ext-redis 精确跳过，或长期在 config.platform 中声明“假装存在”。
为什么 composer install 会因为缺失扩展报错
Composer 在安装依赖前默认执行环境检查，读取 composer.json 中的 require 和 config.platform.php，再比对当前 PHP 的 extension_loaded() 结果。只要某依赖声明了 "ext-redis": "*"，而你本地没装 redis 扩展，就会中断并抛出类似错误：ext-redis * is missing from your system。
这不是 Composer 主动“卡你”，而是它在帮你提前暴露运行时风险——毕竟很多包会在代码里直接调用 new Redis()，没扩展必然 fatal error。
- 常见触发场景：本地开发机没装所有生产扩展（如
ext-swoole、ext-mongodb）、CI 环境精简镜像、Docker 构建阶段未启用对应扩展 - 注意：
--ignore-platform-reqs会跳过所有扩展 + PHP 版本检查，不是只跳 redis；若只想跳特定扩展，不能靠这个参数 - PHP 版本不匹配也会被一并忽略，务必确认你真能承担兼容性风险
临时跳过单个或多个扩展：用 --ignore-platform-req（带 s 的复数形式是错的）
从 Composer 2.0 开始支持精确忽略，语法是 --ignore-platform-req=ext-name，可多次使用：
composer install --ignore-platform-req=ext-redis --ignore-platform-req=ext-memcached
这个参数只影响平台需求（即 ext-* 和 php 版本），不影响其他依赖解析逻辑。它比 --ignore-platform-reqs 安全得多，推荐作为首选临时方案。
- 必须写全名，比如
ext-gd，不能写成gd或gd.so - 大小写敏感，
ext-Redis是错的，正确是ext-redis - 如果同时要跳 PHP 版本，得额外加一个：
--ignore-platform-req=php - 该参数不写入
composer.lock，换环境执行仍需显式带上
更稳妥的长期做法：用 config.platform 声明“假装有”扩展
在 composer.json 里加一段配置，告诉 Composer：“我虽然没装，但我保证运行时会有”，这样连临时参数都不用加：
"config": {
"platform": {
"ext-redis": "5.3.7",
"ext-mongodb": "1.15.0"
}
}
版本号可以随便写（甚至 "*"），Composer 只校验是否存在，不验证版本语义。这相当于在 lock 文件生成阶段“伪造”了平台能力。
- 适合团队协作：所有人跑
composer install都不会因扩展中断 - CI/CD 可以统一配置，避免漏传参数
- 风险点：如果真没装扩展，后续运行时仍会报错，只是延迟到了 PHP 执行阶段
- 别滥用——比如你根本不用 Redis 功能，却在
platform里声明，反而可能掩盖实际缺失的依赖
为什么不要直接删 ext-xxx 声明
有人想“干脆把 composer.json 里别人的 require 改掉”，这是危险操作：
- 下次
composer update会重置回原始声明，手工改白费劲 - 有些包的功能分支依赖扩展存在性（比如 Laravel 的
cache.redis配置），删了声明可能导致配置失效或静默降级 - 违反依赖契约：作者明确写了“需要 ext-redis”，绕过检查不等于绕过功能依赖
真正该做的，是确认这个扩展是否真的必要——如果项目里压根没用 Redis，那应该让业务代码移除相关调用，而不是让 Composer 装瞎。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
