composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 能解决依赖下载慢问题，但必须严格满足三点：键名唯一为 repo.packagist、type 值必填小写 composer、url 须为 https 且末尾带 /；否则静默失效。
直接配 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能解决绝大多数 PHP 项目依赖下载慢、卡在 Loading composer repositories 的问题，但 90% 失败不是网络或镜像本身，而是命令漏了关键要素，导致配置静默失效。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但 composer install 依然连 packagist.org，说明根本没读到你设的镜像。核心就三点：
-
repo.packagist是唯一合法键名 —— 写成repos.packagist（多 s）、repository.packagist或packagist.org全部无效 - 中间的
composer是必填type值，小写，不可省略；漏掉就等于没配 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼出/packages.json导致 404）
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是类似 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"} 的完整 JSON。返回空、null、或还是 https://packagist.org，说明失败，立刻重试。
项目级配置比全局更可靠，尤其对 CI 和协作项目
全局配置只对当前 shell 用户生效，而 CI（如 GitHub Actions）、宝塔、Docker 容器里跑命令的用户往往不是你本人（比如是 www、runner 或 www-data），结果配了等于白配。
项目级配置写入 composer.json 的 repositories 字段，优先级高于全局，且能被 Git 跟踪、自动同步给所有协作者和部署环境。
- 进项目根目录（确保有
composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果
composer.json里已有"repositories": []（数组格式），命令会报错；需先手动改成"repositories": {}（空对象） - 配完必须删掉
vendor/和composer.lock，再跑composer install—— 否则旧lock文件仍按原地址解析，镜像形同虚设
换源后仍卡在 Resolving dependencies？那跟镜像无关
Resolving dependencies 阶段完全不走镜像，它只做本地版本约束计算。卡在这里，说明问题出在 composer.json 本身：
-
"php": "^7.4 || ^8.0"这类宽泛约束会让 Composer 尝试遍历大量历史版本，耗时暴涨 -
require-dev里塞了太多包（尤其是 dev 分支或未打 tag 的），也会拖慢解析 - 某些插件（如
laravel-shift）可能在 install 前强制重置源，此时加--no-plugins可临时绕过：composer install --no-plugins
遇到这种情况，别折腾镜像，先用 composer clear-cache 清缓存，再检查 composer.json 的约束是否合理。
HTTPS 报错 cURL error 60 不是镜像问题，是 PHP 的 cafile 没配好
出现 cURL error 60: SSL certificate problem，千万别换 HTTP 镜像 —— 那等于放弃安全校验。真实原因是 PHP 的 OpenSSL 没指向有效的根证书路径。
- 查当前配置：
php -i | grep 'openssl.cafile' - Linux/macOS 临时修复：
export COMPOSER_CAFILE=/etc/ssl/certs/ca-certificates.crt（路径按实际调整） - Windows 用户建议用 Git Bash 运行，避免 cmd 下 OpenSSL 环境混乱
阿里云、腾讯云镜像都用正规 DV 证书，不支持 HTTP 回退。最稳的起点永远是：先确认 composer diagnose 输出里 HTTP proxy 和 CA file 都 OK，再动仓库配置。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
