Composer安装包加速：中文镜像配置教程分享-composer-PHP中文网

composer全局镜像配置config -g repo.packagist常静默失效，因必须同时满足三条件：键名严格为单数repo.packagist、第二参数显式写composer、url须https且末尾带/；任一不符即回退官方源，且无报错。

composer安装包加速：中文镜像配置教程分享

composer install 卡在 Downloading 或 Loading composer repositories，不是网络差，是镜像根本没生效——配错一个字符、少一个斜杠、用户权限不对，都会静默回退到 packagist.org。

为什么 `composer config -g repo.packagist` 总是不生效

这条命令极易静默失败，且不报错。必须同时满足三个硬条件：

repo.packagist 是唯一合法键名（写成 repos.packagist 或 packagist.org 都无效）
中间必须带 composer 这个 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ ✅；漏掉 composer 就 fallback 到官方源 ❌
URL 必须是 HTTPS + 末尾带斜杠：https://mirrors.aliyun.com/composer/ ✅；https://mirrors.aliyun.com/composer ❌（少斜杠会拼出 /composerpackages.json 导致 404）

验证是否成功：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。空、null、或仍是 https://packagist.org，说明没写进去。

项目级配置比全局更可靠

全局配置在宝塔、CI、多用户环境里大概率失效——因为 composer config -g 写的是当前用户的 ~/.composer/config.json，而实际执行命令的可能是 www 或 runner 用户。

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.aliyun.com/composer/（注意：不加 -g）
它会自动在 composer.json 的 repositories 字段里安全追加，不覆盖已有私有源
如果项目原 "repositories": {} 是对象格式，命令会 merge；如果是数组格式（如 "repositories": []），命令会报错，需先手动改成对象
改完必须删掉 vendor/ 和 composer.lock，再跑 composer install，否则旧 lock 文件里的 dist URL 仍直连 GitHub

`composer install` 还卡在 `Downloading https://codeload.github.com/`

配了镜像但依然从 GitHub 下 zip，是因为 Composer 的镜像机制是分层的：packagist.org（或镜像）只提供元数据，而 zip 包默认仍走 GitHub。阿里云等公共镜像不托管 zip，只代理元数据。

执行 composer install -vvv | grep "Downloading"，若看到 https://api.github.com/ 或 https://codeload.github.com/，说明 zip 下载路径没变
临时解法：在项目 composer.json 中为高频包显式指定 dist 地址，例如："dist": {"url": "https://ghproxy.com/https://codeload.github.com/xxx/yyy/zip/1.2.3"}
长期方案：个人开发推荐用 ghproxy.com 类反向代理；企业可部署 satis 或 toran proxy 把 GitHub zip 缓存到内网
注意：--repository-url 参数对 composer require 无效，只影响 install 和 update

换源后 `Resolving dependencies` 还是卡住

这个阶段完全不走网络，是 Composer 在本地穷举满足所有约束的版本组合。镜像对它毫无作用。

检查 composer.json 是否写了过宽的约束，比如 "php": "^7.4 || ^8.0"、"monolog/monolog": "*" 或 "minimum-stability": "dev"
禁用 xdebug：它会让依赖求解慢数倍，执行前加 php -d xdebug.mode=off $(which composer) install
收紧 parallel-downloads：Composer 2.2+ 支持并行下载，设为 10 可提速，但对求解无帮助：composer config -g parallel-downloads 10
别信“清缓存就能解决”——composer clear-cache 只清理元数据缓存，不影响求解逻辑