Composer镜像与ext-检查无关，仅影响下载地址；ext-缺失报错源于PHP环境未启用对应扩展，需通过php -m验证或使用--ignore-platform-req=ext-gd精准跳过。
Composer镜像和ext-*检查完全无关
镜像只改下载地址，不参与平台兼容性校验。当你看到composer install卡在Resolving dependencies并报ext-gd缺失时，不是镜像没配好，而是PHP环境本身缺扩展——镜像此时还没开始工作。
常见误判：换完阿里云镜像后仍报ext-intl错误，就以为镜像失效。其实Downloading阶段变快了（可观察日志里包名下载速度），但Resolving dependencies卡住，说明问题出在本地PHP配置，不是源站响应慢。
-
composer config -g repo.packagist只影响packages.json元数据和包文件的获取路径 - 所有
ext-*校验发生在依赖解析阶段，由Composer读取php -m结果比对composer.json中require字段完成 - 镜像URL写错（比如少
/或用http）会导致404或回退到官方源，但不会导致ext-*报错
--ignore-platform-req=ext 是绕过ext-*检查的正确姿势
开发阶段想跳过扩展检查，必须用命令行参数，而不是换镜像。全局忽略（--ignore-platform-reqs）太粗暴，会同时跳过PHP版本校验；精准跳过某个扩展才安全：
- 只跳过
gd：composer install --ignore-platform-req=ext-gd - 跳过多个：
composer install --ignore-platform-req=ext-gd --ignore-platform-req=ext-mbstring - CI脚本中建议显式带上
--no-dev：composer install --no-dev --prefer-dist --ignore-platform-req=ext-redis
注意：--ignore-platform-req=ext不能写成--ignore-platform-req=gd，必须带ext-前缀，且大小写严格匹配composer.json中的声明。
立即学习“PHP免费学习笔记（深入）”；
项目级platform配置更适合长期协作
把“假装已安装”写进composer.json，比每次敲命令更可靠。执行：
composer config platform.ext-gd "8.1.0"
会在composer.json中生成：
"config": {
"platform": {
"ext-gd": "8.1.0"
}
}
Git提交后，所有协作者和CI环境自动生效。但要注意：
- 它只能模拟“存在”，不能模拟“不存在”（比如禁用
ext-xdebug还得靠--ignore-platform-req） - 值填
"8.1.0"只是占位，Composer不校验该版本是否真实支持，只用来通过依赖解析 - 如果项目已有
"repositories": []（数组），composer config命令会失败，需先手动改为{}对象
如何快速定位到底缺哪个ext-*
默认错误信息太笼统，只说Your requirements could not be resolved。真要查缺什么，得用诊断命令：
- 列出所有缺失项：
composer check-platform-reqs --no-dev - 看详细日志：
composer install -vvv | grep -A5 -B5 "ext-" - 确认PHP实际加载了哪些扩展：
php -m | grep -E "(gd|intl|mbstring)"
特别注意中文系统下php.ini路径陷阱：php --ini输出的Loaded Configuration File才是真实生效路径，改错文件（比如改了php.ini-development）会导致extension=gd被无视。
