解析Composer镜像配置的读取顺序-composer-PHP中文网

composer镜像配置读取顺序为硬编码覆盖链：项目级composer.json的repositories字段（含空数组）→ 全局~/.composer/config.json的repo.packagist → 默认源https://packagist.org/；三者互斥，不合并、不 fallback，遇首个有效即终止查找。

解析composer镜像配置的读取顺序

Composer镜像配置的读取顺序是硬编码逻辑，不是“优先级”而是明确覆盖链

Composer 不会合并或智能选择镜像，它只按固定顺序读取配置，遇到第一个有效定义就停止——后面全丢弃。这个顺序写死在源码里，无法绕过。

项目级 composer.json 中的 repositories 字段（哪怕只是空数组 "repositories": []）→ 完全屏蔽全局配置
全局配置 ~/.composer/config.json 中的 repo.packagist → 仅当项目中无 repositories 字段时生效
默认源 https://packagist.org/ → 仅当以上两者都未定义时兜底

注意：composer config -g repo.packagist 写的是全局配置，但只要项目根目录下 composer.json 里出现 "repositories" 这个 key（无论值是 {}、[] 还是完整对象），Composer 就立刻跳过全局配置，连读都不读。

为什么 `composer config repo.packagist`（没加 `-g`）会写进 `repositories` 数组

这条命令本质是项目级配置操作，它不会新建字段，而是尝试往已有的 "repositories": {} 对象里塞 "packagist" 子项；如果 composer.json 里压根没有 repositories，它会自动创建一个对象结构，而不是数组。

若已有 "repositories": []（数组），命令会失败并报错：Cannot append to array, use object instead
若已有 "repositories": {}（对象），则成功写入 "packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
若手动把 "repositories" 改成数组格式（如 [{"type":"composer","url":"..."}），那 composer config repo.packagist 就完全失效——它只认对象形式

也就是说，composer config repo.packagist 和 composer config -g repo.packagist 虽然命令相似，但作用域、写入位置、数据结构完全不同，混用会导致配置不可预期。

Discussion Composer

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

下载

`repositories` 数组里的条目不是“并行查”，而是“命中即停”

很多人以为 Composer 会挨个请求每个仓库的 /packages.json，等超时再试下一个。实际行为更严格：它并发拉取所有仓库的元数据，但只要**任意一个返回 HTTP 200 + 非空 JSON（哪怕只含一个包）**，就立刻锁定该仓库，后续全部跳过。

阿里云镜像返回 {"packages":{}}（空对象）→ Composer 认为“这个源不提供任何包”，继续往下找
私有 Satis 源返回 {"packages":{"myorg/utils":{...}}} → Composer 立刻认定它支持 myorg/utils，不再查其他源
如果第一个仓库 DNS 失败或 TLS 握手超时 → 直接报错，不会 fallback 到第二个
只有第一个返回明确的 HTTP 404，才触发对第二个仓库的请求

所以把私有源放数组第一位，不是为了“更快”，而是防止同名包被公共源劫持；而 {"packagist.org": false} 必须放在私有源之后、数组末尾，否则它一触发，整个查找流程就提前终止。

验证当前生效的镜像地址，别信“执行完就 OK”

执行 composer config -g repo.packagist 后输出为空、null 或报 Key does not exist，说明配置根本没写进去——不是镜像慢，是命令写错了。

键名必须是 repo.packagist（单数，不能多 s）
中间必须带 composer 类型参数：composer config -g repo.packagist composer https://...
URL 必须 HTTPS 且末尾带 /，否则拼接路径出错，静默回退官方源
验证方式唯一可靠：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}