composer install 报 ext-xxx 缺失是因默认启用平台扩展检查，可用 --ignore-platform-reqs 跳过全部检查，或 --ignore-platform-req=ext-gd 精准忽略单个扩展，但仅跳过安装校验，不解决运行时依赖问题。
composer install 时提示 ext-xxx 缺失，但你确定不需要它
直接原因是 Composer 默认做平台扩展检查（platform requirements），发现 php.ini 里没启用某个扩展（比如 ext-gd、ext-redis），就中断安装。这不是 bug，是设计行为——它想帮你提前暴露运行时风险。
但开发环境或 CI 场景下，你可能压根不跑这部分代码，或者用 Docker 分离了 PHP 环境，此时硬拦反而拖慢流程。
- 最常用解法：加
--ignore-platform-reqs参数，跳过所有扩展和 PHP 版本检查 - 更精准的写法：
--ignore-platform-req=ext-gd（只忽略单个扩展）或--ignore-platform-req=php（只忽略 PHP 版本） - 注意：这个参数只影响当前命令，不会改
composer.json或锁文件逻辑
为什么 --ignore-platform-reqs 不等于“安全绕过”
它只是让 composer install 过去，不代表项目真能跑起来。如果代码里写了 new Redis()，而系统没装 ext-redis，运行时照样报 Class 'Redis' not found。
- CI/CD 中用它没问题——只要最终部署环境已配好扩展，本地跳过只是省时间
- 本地开发慎用：容易掩盖真实依赖问题，尤其当你共享
composer.lock给队友时 - 它也跳过
php版本检查，比如项目要求"php": "^8.1"，但你在 PHP 7.4 下用了--ignore-platform-reqs，后续可能遇到语法错误
composer create-project 也要忽略扩展？
对，create-project 同样触发平台检查，尤其拉取带严格扩展要求的框架（如 Laravel 11 要求 ext-pdo_sqlite）。不加参数会卡在“Your requirements could not be resolved”。
- 正确写法：
composer create-project laravel/laravel myapp --ignore-platform-reqs - 如果只想忽略特定项，比如只跳过
ext-imagick，写成：--ignore-platform-req=ext-imagick - 注意：
--ignore-platform-reqs必须放在命令末尾，否则会被当成包名参数解析失败
长期方案：别总靠忽略，该配环境还是得配
频繁依赖 --ignore-platform-reqs 往往说明环境不一致。比如团队有人用 MAMP、有人用 Docker、有人用系统 PHP，扩展列表天然不同。
- 推荐在项目根目录放
.php-version和.php-ext（非标准，需配合脚本）或用docker-compose.yml固定 PHP 镜像与扩展 -
composer.json里的config.platform可伪造平台信息，例如："platform": {"php": "8.2.0", "ext-gd": "1.0"}——但这只是骗 Composer，不解决运行时缺失 - 真正省心的做法：把扩展检查移到 CI 的 PHP 安装步骤，而不是每次
composer install都绕
绕过很容易，但哪天运维同学在生产机上少装一个扩展，报错信息可不会提醒你当初本地是靠 --ignore-platform-reqs 混过去的。
