composer镜像配置必须严格满足三要素：键名repo.packagist、type值为composer、url以https开头且末尾带斜杠，缺一即静默失效；验证须执行composer config -g repo.packagist，输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
别信“自动选最快”，Composer 本身不测速、不切换、不 fallback；当前最稳的是阿里云镜像（同步延迟 2–5 分钟），但测速结果受 DNS、本地杀软、限流干扰极大，生产环境应固定源而非临时测速。
composer diagnose 为什么不能验证镜像是否生效
它根本不会读你配的镜像——composer diagnose 强制访问 https://packagist.org，完全忽略 composer config -g repo.packagist 或 repositories 配置。报 curl error 7: Failed to connect to packagist.org 不代表镜像坏了，是它设计如此。
它真正有用的检查只有三项：PHP version、OpenSSL、curl 扩展是否存在，这些都不依赖网络。想确认镜像能不能用，必须手动发请求。
- 运行
curl -I https://mirrors.aliyun.com/composer/packages.json - 返回
HTTP/2 200且含Content-Type: application/json→ 基础通路正常 - 卡住、超时、返回
404或403→ 问题在 DNS、代理、TLS 握手，或镜像已停用（如phpcomposer.com）
用 curl 测速 packages.json 的正确姿势
测速不是比谁 ping 得快，也不是看 %{time_total}，而是模拟 Composer 启动时首字节响应时间。关键参数必须对：
- 用
-I（HEAD 请求），不是-s -o /dev/null（GET 下载完整 JSON 浪费带宽） - 超时设
-m 5，防某个镜像卡死拖垮整个脚本 - 指标取
%{time_starttransfer}，它反映服务端返回首字节耗时，最贴近 Composer 实际行为 - URL 必须带
/packages.json后缀，例如https://mirrors.tuna.tsinghua.edu.cn/composer/packages.json；根路径可能重定向或返回 HTML，不可比 - 已停用的源（如
https://packagist.laravel-china.org）别测，白费时间
全局配置 repo.packagist 为什么总不生效
静默失效最常见原因就三个硬性条件没满足，缺一不可：
- 键名必须是
repo.packagist，写成repos.packagist（多一个 s）就彻底无效 - 中间的
composer是type值，不能省：命令是composer config -g repo.packagist composer https://...，漏掉就 fallback 回默认源 - URL 必须是 HTTPS 且末尾带
/，比如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
验证方式唯一可靠：执行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或还是 https://packagist.org，说明根本没写进去。
宝塔、CI、Docker 里镜像不生效的真实原因
全局配置写在当前用户的 ~/.composer/config.json，但宝塔「一键部署」默认用 www 用户跑，CI 流水线用 runner 用户，它们根本读不到你 root 下配的镜像。
- 在宝塔终端先执行
whoami，确认实际用户（通常是www），再切过去重配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中别依赖全局配置，改用临时参数更可靠：
composer install --repository-url=https://mirrors.aliyun.com/composer/ - 项目级配置优先级更高，适合团队协作：进项目根目录运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会写入composer.json的repositories字段，提交到 Git 后所有人行为一致
镜像只加速包下载，不解决 Resolving dependencies 卡顿问题。如果 composer update 卡在依赖解析阶段，和镜像无关，得去查 composer.json 的版本约束是否太宽、composer.lock 是否陈旧、或本地 PHP 环境是否有扩展冲突。
