修改Composer镜像源配置以缩短构建时间-composer-PHP中文网

composer全局镜像配置必须严格满足三要素：键名repo.packagist（单数）、第二参数显式为composer（type值）、url以https://开头且末尾带/，缺一则静默回退官方源；项目级配置优先级更高，需在composer.json中正确设置"repositories"数组并禁用默认源，同时务必清缓存验证。

修改composer镜像源配置以缩短构建时间

直接改镜像源能显著缩短构建时间，但90%的人配错导致完全不生效——关键不在“换”，而在“怎么写对”。

composer config -g repo.packagist 命令必须带三个硬性参数

这条命令不是“试试看”，而是三要素缺一不可：键名、type 值、URL 结尾斜杠。漏一个，Composer 就静默 fallback 到 packagist.org，连错误都不报。

键名必须是 repo.packagist（单数，不是 repos.packagist 或 repositories）
第二参数必须显式写 composer（这是 type 值，不能省略或留空）
URL 必须以 https:// 开头，且末尾带 /（比如 https://mirrors.aliyun.com/composer/，少斜杠会拼出 404 路径）

正确示例：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

错误示例：composer config -g repos.packagist https://mirrors.aliyun.com/composer（多 s、缺 type、少斜杠）

项目级配置优先级高于全局，且结构容易写错

只要项目根目录的 composer.json 含 repositories 字段，全局设置就彻底失效。这不是 bug，是 Composer 明确设计的行为。

常见错误写法：

Discussion Composer

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

下载

只写镜像对象：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}（没关默认源）
漏掉 {"packagist.org": false} 或把它放在数组第二项之后
repositories 是空数组或只含一个对象

正确结构（顺序不能颠倒）：

"repositories": [
  {"packagist.org": false},
  {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
]

换源后仍慢？大概率是缓存没清或根本没走镜像

Composer 缓存的是元数据（如 packages.json），不是包本身。改完配置不清理缓存，旧索引还在，请求依然发往原地址。

必须执行 composer clear-cache（推荐，清全部）
或手动删缓存目录：rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer/（Linux/macOS）
验证是否真走镜像：运行 composer install -vvv，搜索日志里的 GET 行，确认域名是镜像地址；别信速度，快 ≠ 走了镜像

注意：composer diagnose 输出中 Repo packagist.org: 后面的地址才是真实生效源。

Docker 和 CI 环境下镜像配置必须显式写进构建流程

宿主机配了全局镜像，对容器内 composer install 完全无效——构建阶段是全新 root 用户、空 ~/.composer 目录。

推荐做法：在 Dockerfile 的 RUN composer install 前加一行 RUN composer config --global repo.packagist composer https://mirrors.cloud.tencent.com/composer/
更稳妥：用 COPY 把预生成的 config.json 放进 /root/.composer/，避免命令执行失败
最简兜底：直接 RUN composer install --repository=https://mirrors.aliyun.com/composer/，参数直传，不依赖任何配置

注意：--repository 参数优先级高于全局配置，适合 CI 场景快速验证。

真正卡住的地方往往不是镜像本身，而是缓存残留、权限错位（比如 sudo 写到了 /root/.composer/ 却用普通用户跑命令）、或误以为“Resolving dependencies”阶段能靠镜像加速——它只管下载，不管算依赖。