提升更新速度的Composer镜像源配置详解-composer-PHP中文网

直接换镜像源不能自动提速，必须同时满足三要素：键名必须为单数repo.packagist、type值必须显式写composer、url须https且末尾带/，任一不符即静默回退官方源；验证需输出完整json对象如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。

提升更新速度的composer镜像源配置详解

直接换镜像源不能自动提速，必须同时满足三要素：键名写对、type值不省、URL 末尾带 /，否则 Composer 静默 fallback 到 https://packagist.org，你根本不知道它没生效。

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

这不是网络问题，是命令本身写错就彻底失效，且无提示。Composer 2.x+ 对格式极其敏感：

repo.packagist 必须是单数，写成 repos.packagist（多一个 s）或 packagist.org，配置直接被忽略
中间的 composer 是 type 值，不是注释或可选参数，漏掉就等同于没配
URL 必须是 HTTPS，且结尾必须有 /：例如 https://mirrors.aliyun.com/composer/ ✅，而 https://mirrors.aliyun.com/composer ❌（会拼出 /packages.json 导致 404）
验证是否真写进去了，只看这一条：composer config -g repo.packagist。输出必须是完整 JSON，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null 或仍是 https://packagist.org，说明失败

项目级配置比全局更可靠，但写法有硬约束

全局配置在 CI/CD（如 GitHub Actions 的 runner 用户）、宝塔（www 用户）或团队协作中极易失效，因为配置文件路径不一致。项目级配置写进 composer.json，Git 可追踪、环境可复现：

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 composer https://mirrors.huaweicloud.com/repository/php/composer/（注意：不加 -g）
该命令仅在 repositories 是对象结构（如 "repositories": {}）时安全追加；若原为数组（"repositories": []），会报错，需先手动改为对象
切勿手写 "packagist.org": false 单独放在 repositories 外层——这会屏蔽所有基础包校验，导致 require 失败
已有私有源时，别用 composer config 全量覆盖，应手动编辑 composer.json，在 repositories 数组末尾追加新项

换源后依然卡住？清缓存和重装是硬性步骤

镜像只加速元数据拉取和 ZIP 下载，但 Composer 会优先读缓存和旧 composer.lock 中记录的官方地址。哪怕你刚配好，它也可能还在往 packagist.org 发请求：

必须执行 composer clear-cache 清掉本地缓存（路径默认是 ~/.composer/cache）
必须删掉 vendor/ 和 composer.lock —— composer update 不行，它照着旧 lock 文件里的 dist URL 下载
然后跑 composer install，不是 update
验证是否真走镜像：加 -vvv 参数，看日志里是否出现类似 Reading packages.json from cache at .../https---mirrors-aliyun-com-composer/ 的路径