Composer中文镜像仅改变下载源，不影响ext扩展检测与安装路径；ext-gd报错源于PHP环境缺失该扩展，需通过php -m、php --ini及php.ini配置验证并启用，或使用--ignore-platform-req=ext-gd绕过校验。
composer 中文镜像配置本身完全不影响扩展安装目录。镜像只改下载源地址，不干预 ext-xxx 扩展的检测逻辑、安装路径或 PHP 运行时加载行为。
composer install 卡在 ext-gd 报错，不是镜像问题
你看到类似这样的错误：
Problem 1
- Root composer.json requires ext-gd, it is missing from your system.说明 Composer 正在执行平台兼容性校验（Resolving dependencies 阶段），它读的是你当前 PHP 环境实际加载的扩展列表，和镜像源无关。
镜像再快，也不能“装上”你没编译的 gd、intl 或 redis。
-
composer config -g repo.packagist配得再对，也解决不了php -m | grep gd输出为空的问题 - 宝塔面板里用 www 用户跑命令，但
php.ini是 root 编译的？那 www 用户根本看不到ext-gd - Docker CI 构建时用了 alpine 基础镜像，默认不带任何扩展，
ext-mbstring就是不存在的
验证方式很简单：
运行 php -m，确认你要的扩展是否在输出里；
再运行 php --ini，看它实际加载的是哪个 php.ini 文件；
最后检查该 php.ini 是否启用了对应 extension= 行（比如 extension=gd.so）。
--ignore-platform-req=ext-xxx 是绕过检查的正确姿势
想跳过某个扩展的强制要求，必须显式告诉 Composer：“我不管它装没装，先装依赖”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--ignore-platform-req=ext-gd：精准跳过gd，大小写敏感，ext-前缀不能省 -
--ignore-platform-req=ext：批量忽略所有ext-*，但保留 PHP 版本等其他平台约束 -
--ignore-platform-reqs：全局忽略全部平台要求（含 PHP 版本），风险更高，不推荐
注意：
- 这个参数只对
install和update生效，require命令不会应用它 - 它不改变 PHP 实际扩展状态，只是让 Composer 在解析阶段“假装存在”，运行时仍可能 fatal error
项目级 config.platform 比命令行更可控
如果团队多人协作，或 CI 环境固定缺某些扩展，把“模拟存在”写进 composer.json 更可靠：
执行：composer config platform.ext-gd "8.1.0"composer config platform.ext-intl "8.1.0"
会生成类似这样的配置：
"config": {
"platform": {
"ext-gd": "8.1.0",
"ext-intl": "8.1.0"
}
}Git 提交后，所有成员和 CI 都按同一规则解析依赖。
但要注意：它只能“模拟已安装”，不能“模拟未安装”——比如你想禁用 ext-xdebug 来避免开发环境误触发，platform 做不到，还得靠 --ignore-platform-req=ext-xdebug 或调整 php.ini。
真正容易被忽略的点是：镜像配置和扩展可用性属于两个完全独立的链条。
你调了最快的镜像、清了缓存、设了并发下载，结果 Resolving dependencies 卡住 2 分钟——八成是 composer.json 里写了太宽泛的 PHP 版本约束，或者 require-dev 里混进了几十个 dev-main 包，跟镜像、扩展都没关系。
别一卡就怀疑镜像没生效，先看日志里卡在哪一步。
