composer在国内不配镜像常因dns解析卡、tls握手超时等导致无法连通packagist.org；确认未配置需执行composer config -g repo.packagist，输出为空或官方源url即未生效；正确全局配置命令为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，须严格满足键名、type值、末尾斜杠三要素。
composer 在国内不配镜像，基本等于没法用——不是慢，是根本走不通。默认连 packagist.org，DNS 解析卡、TLS 握手超时、首字节延迟高，composer install 卡在 Loading composer repositories 或反复重试 Downloading 是常态，和你家宽带无关。
怎么确认你还没配镜像？
执行 composer config -g repo.packagist：
- 输出为空、null、或 {"type":"composer","url":"https://packagist.org"} → 没配，还在直连官方源
- 输出是 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"} 或纯 URL 字符串 → 已生效
- 运行 composer install -vvv，日志里下载域名仍是 packagist.org → 镜像没起作用，所有加速都白搭
全局配置阿里云镜像（最常用、最稳）
命令必须严格满足三要素，缺一不可：
- 键名是 repo.packagist（不是 repos.packagist，多一个 s 就静默失效）
- 第二个参数必须是 composer（这是仓库类型声明，漏掉会 fallback 到官方源）
- URL 必须以 https:// 开头，且末尾带 /（https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌）
正确命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证：composer config -g repo.packagist
Docker 构建里镜像为啥不起作用？
容器内不读宿主机的 ~/.composer/config.json，你在终端配了，对 Dockerfile 里的 RUN composer install 完全无效。
真正有效的写法只有这几种：
- 在 Dockerfile 中加一行：RUN composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/
- 或直接用参数：RUN composer install --repository=https://mirrors.aliyun.com/composer/
- 或提前把含 "repositories" 的 config.json COPY 进镜像
别忘了分层缓存：把 COPY composer.json composer.lock ./ 放在 RUN composer install 前面，否则改一行代码就全量重装
为什么配了还是卡？重点排查这几点
镜像只加速下载环节，卡在别的地方它帮不上忙：
- Resolving dependencies 阶段卡住？可能是 PHP 内存不足（临时设 COMPOSER_MEMORY_LIMIT=-1）、Xdebug 开着（用 php -d xdebug.mode=off $(which composer) install 临时关）、或 platform 版本和实际 PHP 不匹配
- 日志里出现 GithubRateLimitException 或 403？说明有包硬编码 GitHub URL，需配 Token：composer config -g github-oauth.github.com your_token_here
- composer.lock 里锁的是 dev-master 或 Git 地址？这类依赖绕过镜像源，直连 GitHub，换源无效
- 宝塔、CI 脚本、systemd 服务里跑 composer，默认用的是 www 或 runner 用户，不是你当前 shell 用户 → 得用对应用户身份重配，比如 sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
镜像本身只是“下载快”，但 composer.json 结构、PHP 版本、平台约束、Git 依赖这些，才是真正决定构建成败的隐藏变量。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
