推荐使用 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 一键配置全局镜像，该命令自动适配平台、安全写入、保留原有配置；手动修改 ~/.composer/config.json 易因 json 格式错误导致全局限令失败。
Composer 全局镜像配置本质是修改 composer.json 的 repositories 配置，但直接改全局文件不推荐；真正稳定、可复用的一键方案是使用 composer config 命令操作 COMPOSER_HOME 下的全局配置文件。
为什么不能直接改 ~/.composer/config.json？
手动编辑容易出错，尤其 JSON 格式缩进或逗号遗漏会导致后续所有 composer 命令报错（如 file_get_contents(): Failed to open stream）；且不同系统 COMPOSER_HOME 路径不同（windows 是 %appDATA%Composer），硬编码路径不可靠。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/是唯一推荐的写法 - 该命令自动识别平台，安全写入全局配置，同时保留原有配置项（如 auth tokens）
- 执行后无需 reload 或重启终端，下一次
composer require就生效
阿里云、腾讯云、华为云镜像地址及验证方式
国内主流镜像源均已支持 HTTPS + Packagist 协议兼容，但必须用完整 URL，不能漏掉末尾 /（否则会 404）：
- 阿里云：
https://mirrors.aliyun.com/composer/（最稳定，响应快） - 腾讯云：
https://mirrors.cloud.tencent.com/composer/（部分地区偶发 DNS 解析慢） - 华为云：
https://repo.huaweicloud.com/repository/php/（注意路径不是/composer/）
验证是否生效：运行 composer config -g repo.packagist，输出应为完整 URL；再执行 composer show packagist/support，看请求 URL 是否走镜像域名。
如何临时切回官方源或禁用镜像？
全局镜像不是“开关”，而是显式声明了一个 Packagist 类型仓库。要还原，有且仅有两种干净方式：
- 恢复默认（删掉自定义配置）：
composer config -g --unset repos.packagist - 显式设回官方源：
composer config -g repo.packagist composer https://packagist.org
注意：composer config -g disable-tls true 这类错误操作会破坏安全性，绝不要加；镜像本身都支持 TLS，不需要关。
CI/CD 或 docker 环境下怎么预置镜像？
在构建阶段写死镜像比每次运行时判断更可靠，但需避开用户 home 目录（CI 环境常无持久 ~/.composer）：
- Dockerfile 中用
ENV COMPOSER_HOME=/tmp/composer+RUN composer config -g ... - gitHub Actions 可直接在
steps中加一行：run: composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 避免用
sed或echo >>拼 JSON，极易因换行/引号崩坏配置
镜像配置本身极轻量，但一旦写错，所有依赖安装都会卡在「Loading composer repositories」阶段，而错误提示往往藏在 verbose 日志里——所以宁可多跑一次 config -g 验证，也不要跳过这步。