Composer设置镜像地址教程_Composer设置镜像地址方法【指导】-composer-PHP中文网

直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 即可全局生效，因其写入 ~/.composer/config.json，覆盖旧镜像、兼容1.x/2.x，且url末尾必须带 /，否则404；但若项目级 composer.json 含 repositories 字段则会优先覆盖全局配置。

composer设置镜像地址教程_composer设置镜像地址方法【指导】

直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效，不用改文件、不需重启 PHP、也不依赖项目配置——但前提是没被更高优先级的设置覆盖。

为什么 `composer config -g` 是首选方式

这条命令写入的是全局配置文件 ~/.composer/config.json，所有后续的 composer create-project、composer require、composer install 都会自动走镜像，包括新初始化的项目。它不碰缓存、不编辑 JSON 手动出错、兼容 Composer 1.x 和 2.x。

repo.packagist 是唯一被官方认可的主源键名，别写成 repos.packagist（多一个 s）或 mirror（完全无效）
URL 必须以 / 结尾，比如 https://mirrors.aliyun.com/composer/ ✅，少斜杠会拼出 https://mirrors.aliyun.com/composer/packages.json 这类错误路径，导致 404
Windows 用户执行完要关掉当前终端再重开，否则 shell 可能仍读取旧环境变量或缓存的配置
这条命令是覆盖式写入，之前设过的其他镜像（比如腾讯云或 phpcomposer.com）会被直接替换，不是追加

执行后还是走 `packagist.org`？先查优先级

Composer 的镜像源有明确作用域顺序：项目级 composer.json 中的 repositories > 全局配置 > 默认源。只要项目目录下有 composer.json 并含 "repositories": [...]，哪怕只有一行空数组，全局设置就完全失效。

Discussion Composer

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

下载

进项目目录后运行 composer config repo.packagist，如果输出 URL，说明项目级已覆盖；输出 Key "repo.packagist" does not exist，才轮到全局
检查 composer.json 里是否有 "repositories" 字段——CI/CD 流水线里常有人误加，导致本地调试正常、线上构建变慢
composer diagnose 的输出里看 Repo packagist.org: 后面是不是你设的镜像地址，不是就说明没生效
CI 环境中用 sudo composer config -g，结果写进了 root 用户的 ~/.composer/config.json，但构建用的是普通用户，根本读不到

多个镜像怎么配才真正 fallback

Composer 不会“自动选最快的”，它严格按 repositories 数组顺序尝试：第一个返回 HTTP 404 才查第二个；如果第一个超时、500 或 DNS 解析失败，就直接报错，不会往下走。

想实现兜底，得手动写数组形式的全局配置，例如：

composer config -g repositories.0.type composer
composer config -g repositories.0.url https://mirrors.aliyun.com/composer/
composer config -g repositories.1.type composer
composer config -g repositories.1.url https://packagist.org/

注意这里用的是 repositories.0 而非 repo.packagist，后者只支持单源，前者才支持多源数组
这种写法下，阿里云挂了才会切官方源，但官方源响应慢、限流严，实际体验可能更差——多数人不如只配一个稳定镜像
华为云、腾讯云镜像更新频率不如阿里云（后者约 96 秒同步），选镜像别只看“有没有”，要看“更新快不快、稳不稳”

最常被忽略的一点：改完配置后，composer install 仍可能从本地缓存拉旧包，看不出是否真走镜像。验证必须带 -vvv 看实际请求域名，或者清缓存后重试：composer clear-cache。镜像地址末尾少个 /、项目里多一行 "repositories": []、Windows 没重启终端——这三个地方占了 80% 的“明明设了却不生效”问题。