Composer基础到进阶：如何科学利用国内镜像源提速-composer-PHP中文网

composer镜像配置失效主因是键名错（应为单数repo.packagist）、漏type值“composer”、url末尾无/，三者任一出错即静默回退官方源；验证需确认config输出为完整json、diagnose域名匹配、-vvv日志请求地址正确。

composer基础到进阶：如何科学利用国内镜像源提速

镜像只加速元数据拉取和包下载，不解决 Resolving dependencies 卡顿；配置写错会静默 fallback 到官方源，你根本看不到报错。

为什么 `composer config -g repo.packagist` 没生效

90% 的“换镜像还是慢”源于这条命令根本没写进去，且 Composer 不报错、不提示——它只是默默回退到 https://packagist.org。

repo.packagist 不能写成 repos.packagist（多一个 s 就彻底失效）
中间的 composer 是 type 值，不是可选参数，漏掉或写成 https 都不行
URL 必须是 HTTPS 且末尾带 /：比如 https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（缺斜杠会导致 404 或空响应）
必须加 -g，否则只改当前目录下的 composer.json，换个项目就失效

验证方式唯一可靠：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍显示 https://packagist.org，说明没写成功。

项目级配置如何避免清空私有仓库

项目已有 "repositories" 字段时，直接跑 composer config repo.packagist 命令会全量替换整个字段，把你配好的 Git 私有源、Satis 源一并抹掉。

已有 "repositories": { "my-private": { "type": "vcs", ... } }？别用命令，手动编辑 composer.json，在 repositories 对象里加一条 "packagist": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" }
根节点必须同时写 "packagist.org": false（注意：不在 repositories 内部，而在顶层），否则私有源 + 镜像共存时可能触发冲突或校验失败
别写 "packagist": false——这会导致 PHP 扩展、语言版本等基础约束校验失败

改完后执行 composer update --lock，确保 composer.lock 记录的是新源地址，而不是残留的官方源 hash。

Discussion Composer

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

下载

`Resolving dependencies` 卡住，换镜像完全无效

执行 composer install -vvv 或 composer update -vvv，观察日志最卡的位置：

如果卡在 Downloading、Fetching package、大量 GET https://.../dist/xxx.zip —— 镜像能立竿见影（从几分钟降到秒级）
如果卡在 Resolving dependencies 超过 10 秒，甚至反复回溯版本树 —— 这是本地约束太宽导致求解器指数级爆炸，和镜像无关
典型诱因："php": "^7.4 || ^8.0" 这类跨大版本约束、"monolog/monolog": "*" 模糊版本号、require-dev 包过多、Xdebug 开着

此时该做的是收紧版本约束、禁用 Xdebug、清 Composer 缓存（composer clear-cache），而不是折腾镜像 URL。

并发下载没开，再快的镜像也跑不满带宽

Composer 2.2+ 支持并行下载，但默认只开 3 个并发线程——相当于把千兆宽带压成百兆用。

执行 composer config -g parallel-downloads 8（推荐值；设为 10 容易触发临时文件竞争，报 file_put_contents(/tmp/): failed to open stream）
该设置仅对 composer install 生效；composer update 仍需串行解析依赖图，本质无法并行
CI 环境中若使用非 root 用户（如宝塔的 www 用户），全局配置写在 /root/.composer/config.json 是无效的，得针对实际 UID 配置

镜像地址、并发数、项目级 repositories 结构，三者缺一不可——少一个，提速效果就打对折；其中任何一个写错，都可能让你以为“镜像没用”，其实它根本没跑起来。