已配置中文镜像需满足:全局或项目级 config 中 repo.packagist 指向有效 HTTPS 镜像 URL(如清华源 https://mirrors.tuna.tsinghua.edu.cn/packagist/),且实际请求日志显示该域名;phpcomposer.com 已停服,旧配置会降级回官方源。

查看当前全局镜像配置
直接运行 composer config -g repo.packagist,如果返回的是类似 {"type": "composer", "url": "https://packagist.phpcomposer.com"} 或包含 mirrors.tuna.tsinghua.edu.cn、packagist.phpcomposer.com、packagist.laravel-china.org 这类域名,说明已配置中文镜像。
如果返回空或报错 There is no element matching 'repo.packagist',说明没设过全局镜像,走的是官方源(https://packagist.org)。
- 注意:有些老教程推荐的
phpcomposer.com已于 2022 年停止服务,若看到这个地址,实际请求会失败或降级回官方源 -
composer config -g只显示全局配置;项目内配置优先级更高,需进项目目录再查
检查项目级镜像是否覆盖全局
进入具体项目目录后,运行 composer config repo.packagist(去掉 -g)。如果返回非空结果,说明该项目单独设置了镜像,会屏蔽全局配置。
常见误操作是:在项目里执行过 composer config repo.packagist https://mirrors.tuna.tsinghua.edu.cn/packagist/,但没加 --global,结果只改了当前项目,其他项目仍走慢速官方源。
- 项目级配置写在
composer.json同级的composer.lock不生效,只读取composer.json中的repositories字段或config.repo.packagist - 如果项目
composer.json里手动写了"repositories"数组,它会完全接管包源逻辑,此时repo.packagist配置被忽略
用 debug 命令验证实际请求地址
最可靠的方式不是看配置,而是看 Composer 真正发请求时连的是哪个域名。运行 composer diagnose -v,观察输出中类似 Checking composer.json: OK 后面是否出现 Downloading https://mirrors.tuna.tsinghua.edu.cn/... 这样的日志行。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
或者更直接:删掉 vendor/ 和 composer.lock,执行 composer install -v,从 verbose 日志里找第一行 Downloading 的 URL。
- 某些镜像(如清华源)会在响应头里带
X-Server: TUNA-Mirror,用curl -I https://mirrors.tuna.tsinghua.edu.cn/packagist/packages.json可快速确认源可用性 - 如果日志里反复出现
https://packagist.org/,哪怕配置写了镜像,也可能是镜像地址格式错误(比如漏了末尾/或协议写成http)
常见配置错误与修复命令
中文镜像必须用完整 URL,且协议为 https,否则 Composer 会静默回退到官方源。清华源当前有效地址是 https://mirrors.tuna.tsinghua.edu.cn/packagist/(注意末尾斜杠)。
重设全局镜像的正确命令是:
composer config -g repo.packagist '{"type": "composer", "url": "https://mirrors.tuna.tsinghua.edu.cn/packagist/"}'
如果之前设错了,先清空再重设:
composer config -g --unset repo.packagist
- 不要用
composer config -g repo.packagist https://xxx这种简写——它会把值当成字符串而非对象,导致后续install报错Invalid repository type - 阿里云镜像(
https://mirrors.aliyun.com/composer/)目前仍可用,但部分包同步有数小时延迟,紧急更新时建议切回清华源
composer install 也会超时回退——得配合 ping 和 curl -v 一起看。

















