一文学懂Composer国内镜像的全局应用-composer-PHP中文网

composer config -g repo.packagist 总不生效是因为键名必须为单数repo.packagist、type值必须显式写composer、url须https且末尾带/，三者缺一即静默回退官方源；验证需输出完整json如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。

一文学懂composer国内镜像的全局应用

composer config -g repo.packagist 为什么总不生效

不是网络卡，是命令写错三个硬性条件，导致静默回退到 packagist.org——不报错、不提示、配置为空。

repo.packagist 必须是单数，写成 repos.packagist（多一个 s）就完全无效
composer 是 type 值，必须显式写在 URL 前面，漏掉就 fallback 到官方源
URL 必须用 HTTPS，且末尾带斜杠 /，少斜杠会拼出 /composerpackages.json 导致 404

验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回空、null 或报 Key not found，说明没写进去。

全局镜像 vs 项目级镜像，该选哪个

全局配置看着省事，但 CI/CD、宝塔、Docker 容器里常读不到——因为 -g 写的是当前用户家目录下的 ~/.composer/config.json，而 GitHub Actions 默认用 runner 用户，宝塔用 www 用户，它们的配置文件是空的。

Discussion Composer

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

下载

项目级配置优先级更高，写进 composer.json，拉代码即生效，团队协作更一致
进项目根目录后执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
它会自动在 composer.json 顶层添加或合并 "repositories" 字段，key 固定为 "packagist"
已有私有源？别用 config 命令覆盖整个 repositories，应手动编辑，在数组里追加 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}

composer create-project 还是慢，怎么办

这个命令不读全局镜像配置，会绕过 repo.packagist 直连 packagist.org 下载 skeleton 包——所以即使全局配好了，create-project 仍可能卡在 Loading composer repositories。

必须显式加 --repository-url 参数：composer create-project laravel/laravel myapp --repository-url=https://mirrors.aliyun.com/composer/
某些框架 starter 模板含 Git 克隆步骤（如 Symfony），镜像只加速包下载，Git 部分需另配代理或换国内 fork
新发布的包（尤其 dev-main 分支）可能有 5–30 分钟同步延迟，查不到时先访问 https://mirrors.aliyun.com/composer/packagist/ 确认是否已收录