如何将Composer镜像源修改为国内源-composer-PHP中文网

composer全局镜像配置失效的主因是键名错误、缺失type值或url缺末尾/，三者任一出错均静默回退官方源；项目级repositories字段优先于全局配置，且必须执行clear-cache并验证-vvv日志中的域名。

如何将composer镜像源修改为国内源

直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效，但写错键名、漏掉 composer 类型、URL 缺末尾 /，三者任一出错都会静默回退到官方源——命令不报错，composer install 却还在下载 packagist.org。

为什么 `composer config -g repo.packagist` 总没反应

不是网络慢，是配置根本没被 Composer 读进去。常见原因有三个：

repo.packagist 键名写成 repos.packagist（多一个 s）：Composer 完全忽略该字段
中间漏掉 composer 这个 type 值，例如写成 composer config -g repo.packagist https://mirrors.tuna.tsinghua.edu.cn/composer/：Composer 5.0+ 会警告 Repo is not configured properly，部分包仍走官方源
URL 少了末尾斜杠，如 https://mirrors.ustc.edu.cn/composer：会拼出错误路径 /composerpackages.json，返回 404

验证是否真写进去了：composer config -g repo.packagist 输出必须是完整 URL 字符串或 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）。空、null 或还是 https://packagist.org，说明没成功。

全局配置 vs 项目级配置，哪个优先？

项目级配置永远优先于全局配置。只要项目根目录 composer.json 顶层有 "repositories" 字段，全局设置就自动失效。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

检查项目是否已覆盖：进项目目录后运行 composer config repo.packagist，有输出说明项目自己写了源
想保留私有源又加镜像？别手写 JSON，用命令安全合并：composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（不带 -g）
如果项目 composer.json 的 "repositories" 是数组（比如含私有源），composer config 命令会失败，需先手动转成对象形式："repositories": {}

换源后还卡在 Resolving dependencies 或 Downloading？

镜像只加速下载阶段，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒以上，和镜像无关。

必须执行 composer clear-cache：旧缓存可能残留 packagist.org 元数据，导致仍尝试回源
检查 COMPOSER_HOME 环境变量是否指向错误路径，导致配置加载错位置
企业网络可能拦截 HTTPS 请求，可临时试 http://mirrors.aliyun.com/composer/（仅调试，勿长期用）
CI 流水线中若用 Docker，必须把 /etc/composer/config.json COPY 进镜像——构建时用 composer config -g 生成的配置对运行时用户无效

如何验证镜像真正在用？

别信“命令没报错”，要看真实请求地址：

运行 composer install -vvv 2>&1 | grep "Downloading"
确认日志里出现的域名是 mirrors.aliyun.com、mirrors.tuna.tsinghua.edu.cn 或 packagist.mirrors.ustc.edu.cn，而不是 packagist.org
如果用的是系统级配置（/etc/composer/config.json），必须用真实运行用户验证：sudo -u www-data composer config repo.packagist

最易被忽略的是：项目 composer.json 里一个多余的 "repositories" 字段，就能让所有全局配置失效；而 clear-cache 不执行，镜像再快也白搭。