Composer代理配置提高团队协作效率-composer-PHP中文网

composer镜像配置未生效的根本原因是全局配置未写入实际运行用户的配置文件，常见错误包括键名拼错（如repos.packagist）、缺type值、url末尾无斜杠、项目级repositories屏蔽全局配置，且未清缓存和composer.lock导致构建不一致。

composer代理配置提高团队协作效率

Composer代理配置没走通，团队协作效率反而下降——不是镜像源慢，是部分人走镜像、部分人走官方，composer.lock里混着两种来源的 hash，CI 构建时反复失败。

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

它根本没写进真正运行命令的用户的配置文件里。你在终端用 root 执行了该命令，但 CI 脚本或宝塔部署是以 www 用户跑的，它读的是 /home/www/.config/composer/config.json，不是 /root/.config/composer/config.json。

composer config -g repos.packagist（多一个 s）会静默写进无效字段，查 composer config -g repo.packagist 输出为空，但命令不报错
漏掉 "type": "composer" 值，比如只写 composer config -g repo.packagist https://mirrors.aliyun.com/composer/，Composer 2.x 会 fallback 回官方源
URL 少了末尾 /，请求变成 /composerpackages.json 直接 404，然后静默 fallback
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报错，或只返回 URL 字符串，都说明没写进去

项目级 `repositories` 怎么写才不翻车

项目 composer.json 里的 repositories 必须是数组，且第一项必须是 {"packagist.org": false}——不是合并进第二项，也不是写成对象。

Discussion Composer

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

下载

"repositories": {"packagist.org": false} ❌ 会被忽略，因为 repositories 必须是 []，不是 {}
"repositories": [{"packagist.org": false, "type": "composer", "url": "https://mirrors.aliyun.com/composer/"}] ❌ 第一项不能混 type 和 url，{"packagist.org": false} 必须独立成项
正确写法是："repositories": [{"packagist.org": false}, {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]
镜像 URL 必须以 / 结尾，否则路径拼接错误，404 后 fallback 到官方源

改完配置后为什么还是走官方源

改完不删 vendor/ 和 composer.lock，composer install 仍按 lock 文件里旧的 dist URL 下载，根本不会走新镜像。

必须先删除 vendor/ 和 composer.lock
再执行 composer install（不是 update），否则旧 lock 文件仍指向官方源
如果用了项目级配置，推荐进项目根目录执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/，它会自动安全写入 composer.json 的 repositories 字段，key 固定为 "packagist"，不覆盖私有源
这条命令不依赖用户环境，CI 拉代码后直接生效；但前提是 composer.lock 已提交并被清空重装