详解Composer镜像源同步的并发数调整-composer-PHP中文网

composer并发未生效主因是镜像未正确配置：全局repo.packagist必须为带尾斜杠的国内镜像url且含"type":"composer"，拼写错误、缺斜杠、被项目repositories覆盖均会导致并发失效；唯一有效参数是http-max-concurrent-downloads（≥2.2版本），推荐本地设8、ci设4；多镜像需配"canonical":false并验证日志交替下载。

详解composer镜像源同步的并发数调整

为什么改了并发数，composer install 还是单行下载？

并发没生效，大概率是镜像根本没配对——composer config -g repo.packagist 输出不是国内镜像 URL（比如仍是 https://packagist.org 或为空），那所有并发参数都白设。Composer 只在请求真正打到镜像时才启用并发池，境外源下开 10 个线程也卡在 TLS 握手和 DNS 解析上。

常见配置错误包括：

repo.packagist 拼成 repos.packagist（多一个 s），Composer 完全忽略且不报错
URL 缺末尾斜杠：https://mirrors.aliyun.com/composer ❌ → 必须是 https://mirrors.aliyun.com/composer/ ✅
项目级 composer.json 里有 repositories 字段，会直接覆盖全局镜像配置

验证是否生效：运行 composer config -g repo.packagist，输出必须是带 "type": "composer" 的完整 JSON，且 url 值为国内镜像地址（如 https://mirrors.tuna.tsinghua.edu.cn/composer/）。

该用 http-max-concurrent-downloads 还是 parallel-downloads？

parallel-downloads 是 Composer 2.2 初期短暂存在的配置项，已在 2.2+ 正式弃用，设了也不生效。唯一有效、被底层 HttpDownloader 实际读取的参数是 http-max-concurrent-downloads。

这个值控制 HTTP 请求池大小，影响 install、update、require 全部命令的下载阶段，但只对 Composer ≥2.2 生效：

确认版本：composer --version，低于 2.2.0 必须先 composer self-update
全局设置：composer config -g http-max-concurrent-downloads 8
临时覆盖（CI 推荐）：COMPOSER_MAX_PARALLEL_HTTP_REQUESTS=4 composer install
拼写必须严格：http-max-concurrent-downloads，少字、多连字符、漏 http- 都无效

并发数设多少才不触发镜像限流？

国内主流镜像（阿里云、腾讯云、清华）普遍对单 IP 设硬性 QPS 上限（如 60 次/分钟）。设太高不是更快，而是更快收到 429 Too Many Requests 或静默超时。

Discussion Composer

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

下载

不同场景推荐值：

本地开发机（带宽充足）：http-max-concurrent-downloads 8 是稳妥上限
CI/CD 构建节点（多任务并发）：COMPOSER_MAX_PARALLEL_HTTP_REQUESTS=4 更安全
弱网或老旧 CI 环境：2 是底线，避免雪崩式重试
别设 1：退化为串行，丧失 Composer 2 并发能力
别设 20：极易触发 file_put_contents(/tmp/): failed to open stream（临时文件竞争）或 416 Requested Range Not Satisfiable

注意：composer update 因依赖图需实时解析，元数据拉取始终串行，调高并发无意义；只有 install 阶段的包体下载才真正受益。

多镜像 + 故障转移才是高并发稳定的关键

单镜像扛不住 CI 并发压力。清华镜像每 IP 每分钟最多 60 次请求，多个构建节点同时打过去，秒级就 429。必须用 mirrors 数组实现自动故障转移，而不是只换一个源。

正确配置方式（写入项目 composer.json 的 repositories 段）：

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://mirrors.aliyun.com/composer/",
            "canonical": false
        },
        {
            "type": "composer",
            "url": "https://mirrors.tuna.tsinghua.edu.cn/composer/",
            "canonical": false
        },
        {
            "type": "composer",
            "url": "https://mirrors.huaweicloud.com/repository/php/",
            "canonical": false
        }
    ]
}

"canonical": false 是关键：缺它，Composer 只认第一个镜像，后面全是摆设。验证是否生效，看 composer install -vvv 日志里是否出现多个域名交替下载（如 Downloading https://mirrors.aliyun.com/... 和 Downloading https://mirrors.tuna.tsinghua.edu.cn/... 交错出现）。

同步要做的三件事不能漏：清缓存（composer clear-cache）、降并发（composer config -g repos.packagist.org.concurrent-downloads 2）、配多镜像。漏掉任意一个，429 和卡在 Downloading 就还会回来。