composer不支持在composer.json中直接配置镜像地址，必须通过composer config命令设置repo.packagist（2.2+需用repositories.packagist.org）或环境变量，项目级repositories字段会完全覆盖全局配置，且镜像本质是packagist反向代理，不能作为独立仓库硬编码。
composer.json 里不能直接配置镜像地址
直接在 composer.json 中写镜像 URL 是无效的——Composer 不读取这个文件里的镜像配置。镜像设置属于全局或项目级的网络行为控制，必须通过 config 命令或 composer.json 的 repositories 字段间接干预，但后者用途完全不同。
用 composer config 设置全局或项目镜像
真正生效的方式是运行 composer config 命令，它会修改 composer.json 中的 repositories 配置（注意：不是镜像，而是包源），或者更常用的是修改全局/项目级的 config 项。国内用户最常需要的是替换 Packagist 官方源：
-
composer config -g repo.packagist composer https://packagist.phpcomposer.com（已停用，仅作示例） -
composer config -g repo.packagist composer https://packagist.org（恢复官方源） - 推荐使用阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 仅对当前项目生效，去掉
-g：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
执行后，Composer 会在 composer.json 里自动加一段 "repositories" 配置，但本质是覆盖默认 Packagist 源，不是“指定镜像”而是“换源”。
为什么不能靠 repositories 字段手动写镜像？
有人尝试在 composer.json 的 repositories 里硬写一个 type=package 或 type=composer 的条目指向镜像地址，这是误解。镜像不是独立仓库，它只是 Packagist 的反向代理，不提供额外元数据接口。强行添加会导致：
- Composer 报错
Could not fetch packages from "xxx": Invalid response code - 依赖解析失败，因为镜像不响应
/packages.json等 Composer 协议路径 - 某些镜像（如腾讯云）甚至关闭了非标准请求头，导致
repositories方式彻底失效
唯一合规方式是让 Composer 认为“这就是 Packagist”，靠 config repo.packagist 实现协议级替换。
检查和验证镜像是否生效
配置完别急着 install，先确认实际使用的源：
- 看当前配置：
composer config repo.packagist（输出应为镜像 URL） - 查实际请求地址：
composer diagnose -v会显示 “Checking platform settings” 下的源地址 - 抓包验证（必要时）：
COMPOSER_HTTP_PROXY=127.0.0.1:8080 composer install配合 mitmproxy，确认请求发往的是镜像域名而非 packagist.org
注意：部分公司内网或 CI 环境会覆盖 COMPOSER_REPO_PACKAGIST 环境变量，此时 config 设置会被忽略——得优先查环境变量。
