Composer使用之如何配置多个私有镜像仓库-composer-PHP中文网

repositories必须是索引数组而非键值对，composer仅识别方括号定义的数组，每个元素须为含type和url字段的json对象；镜像顺序即查找顺序，仅404触发fallback，超时或502直接报错；需显式禁用packagist.org以防隐式兜底；多镜像只能通过项目级composer.json配置，全局config无法叠加。

composer使用之如何配置多个私有镜像仓库

repositories数组必须是索引数组，不能写成键值对

很多人复制配置时把 repositories 写成对象（比如 {"aliyun": {...}, "tencent": {...}}），结果只有最后一个生效。Composer 只认方括号定义的索引数组，每个元素必须是独立的 JSON 对象，且含 type 和 url 字段。

✅ 正确写法："repositories": [ {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}, {"type": "composer", "url": "https://mirrors.tencent.com/composer/"} ]
❌ 错误写法："repositories": { "aliyun": {"type": "composer", "url": "..."}, "tencent": {"type": "composer", "url": "..."} }
如果混用私有 VCS 仓库和镜像，type 必须严格匹配：Git 地址用 vcs，HTTP 索引服务用 composer，否则 Composer 会尝试 git clone 一个 HTML 页面并报错

镜像顺序 = 实际查找顺序，404 才查下一个，超时或 502 不 fallback

Composer 按 repositories 数组从上到下线性查找，只在某个源返回明确的 404（包不存在）时才试下一个；遇到 DNS 失败、502、连接超时，直接中断报错，根本不会触发“备选”逻辑。

Discussion Composer

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

下载

阿里云镜像返回 500 → 报错 Could not fetch packages.json，腾讯云镜像完全不被访问
阿里云镜像尚未同步新包 → 返回 404 → 才轮到腾讯云，但后者也可能没同步，最终仍失败
想模拟可用性 fallback，得靠外部脚本检测，例如：curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json 返回 200 才认为可用

必须显式禁用 packagist.org，否则它永远隐式兜底

只要没在 composer.json 根级写 "packagist.org": false，Composer 就会在所有你声明的 repositories 查完后，自动追加官方源作为最终 fallback——这会导致私有同名包被跳过，或认证失败后仍暴露请求。

⚠️ 注意："packagist.org": false 是顶层字段，不是 repositories 数组里的某一项
别写成 {"type": "composer", "url": "https://packagist.org"}，这会启用官方源并覆盖镜像加速效果
若还需元数据兜底（避免镜像未及时更新根索引导致新包找不到），可在 repositories 末尾加 {"packagist": true}，它只查元数据，ZIP 包仍走第一个镜像

全局 config -g 无法叠加镜像，多镜像只能靠项目级 composer.json

composer config -g repo.packagist https://xxx 反复执行只会覆盖，因为 repo.packagist 是单值字段。想真正启用多个镜像，唯一可靠方式是编辑项目根目录下的 composer.json，手动维护 repositories 数组。

全局配置（~/.composer/config.json）会被项目级 composer.json 的 repositories 完全覆盖，不是合并
执行 composer config repositories 可确认当前实际生效的源列表，避免被旧的全局配置干扰
改完 composer.json 后，记得运行 composer update --lock 或删掉 composer.lock 重装，否则 install 仍按旧 lock 文件拉取