常用开源镜像站中的Composer镜像源配置-composer-PHP中文网

配错 composer 镜像源等于没配，必须同时满足键名 repo.packagist、type 值为 composer、https 且末尾带 / 的 url、正确执行上下文四个条件，否则静默回退官方源。

常用开源镜像站中的composer镜像源配置

配错就等于没配，国内 Composer 镜像源不是“换地址就行”，必须同时满足键名、type 值、URL 格式、执行上下文四个硬性条件，否则静默 fallback 到 packagist.org，连 warning 都不报。

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

它不是失败，而是被 Composer 直接忽略——漏掉任意一个要素，配置就不会写进全局文件，composer install 仍走官方源。

repo.packagist 是唯一合法键名（注意是 repo 单数，repos.packagist 或 packagist.org 全部无效）
第二个参数 composer 是 type 值，不是注释，不能省略，也不能写成 composer.org 或留空
URL 必须是 HTTPS 且末尾带 /：例如 https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（会拼出 /packages.json 导致 404）
Windows 用户执行后需重启终端；Linux/macOS 下若用 sudo composer config -g，配置写进了 /root/.composer/config.json，普通用户运行时读不到

验证是否真写进去了？只有一种方式：composer config -g repo.packagist。输出必须是完整 JSON 对象，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或提示 Key "repo.packagist" does not exist，说明根本没写成功。

项目级配置为什么比全局更可靠

CI 流水线（GitHub Actions、GitLab Runner）、宝塔面板、Docker 容器默认以 www、runner 等非登录用户身份运行，完全读不到你本地 ~/.composer/config.json 里的全局配置。

Discussion Composer

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

下载

进项目根目录（含 composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
该命令会向 composer.json 顶层写入 "repositories" 字段，key 固定为 "packagist"，不会覆盖已有私有源——但前提是原 "repositories" 是对象（{}），不是数组（[]）；若是数组，先手动改成空对象再重试
改完必须删掉 vendor/ 和 composer.lock，再跑 composer install（不是 update），否则旧 lock 文件仍按原始元数据地址解析，镜像形同虚设
项目级配置优先级永远高于全局，哪怕你本地配了全局，只要项目里有 repositories，就一定走项目级定义

多个镜像源怎么配才真正起作用

Composer 不并行查源，而是按 repositories 数组顺序逐个尝试，第一个能返回包信息的源就用它，后面全跳过。把国内镜像放前面、官方源放最后兜底，才是有效多源。

推荐写法（手动编辑 composer.json）：

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

千万别写 "packagist": false 或 "packagist.org": true——前者会让基础包全拉不到，后者等同于没配
Composer 2.2+ 默认启用 packagist.org fallback 机制，即使你配了镜像，它仍会悄悄尝试访问官方源做校验；禁用方式：composer config -g repo.packagist.allow-fallback false
阿里云、腾讯云、清华 TUNA 镜像都已支持 Composer 2.7，但注意：部分老镜像未正确实现 packages.json 的签名字段，可能触发 lock 文件哈希校验失败

临时切换镜像源（单次命令有效）

适合快速验证某个镜像是否可用，或绕过当前配置问题，不修改任何配置文件。

加 --repository 参数指定地址，例如：composer create-project laravel/laravel myapp --repository=https://mirrors.tuna.tsinghua.edu.cn/composer/
注意：旧版 Composer 可能报 Unknown option: repository，此时需升级到 2.2+
部分镜像同步有延迟（阿里云约 5–10 分钟，腾讯云通常更及时），若报 Could not find package，先确认镜像是否已同步
临时命令不解决缓存污染问题，仍建议搭配 --no-cache 使用：composer install --no-cache -vvv 2>&1 | grep "Downloading" 观察真实请求域名

最易被忽略的一点：镜像只加速元数据下载和 ZIP 包拉取，对 Resolving dependencies 阶段毫无影响。如果卡在这里，问题一定出在 composer.json 的版本约束太宽、require-dev 过多，或本地 PHP 环境缺少扩展（如 ext-zip），跟镜像无关。