Composer国内源并发压力限流方案-composer-PHP中文网

设高并发反而卡死，因国内镜像限qps且本地临时文件争抢；推荐开发机设6、ci容器设4、windows上限6，并须用repos.packagist.org.concurrent-downloads键名且验证日志轮换。

composer国内源并发压力限流方案

为什么设 high parallel-downloads 反而卡死

并发数不是越高越好，国内镜像（阿里云、腾讯云、清华）普遍对单 IP 限 QPS（如 60 次/分钟），设 parallel-downloads > 8 就容易触发 429 或静默超时；更隐蔽的问题是 PHP 进程在 /tmp（Linux/macOS）或 %TEMP%（Windows）里争抢写同名 ZIP 文件，报 file_put_contents(): failed to open stream 不是镜像问题，是本地竞态。

推荐值分场景：

开发机（8GB+ 内存）：全局设 composer config -g parallel-downloads 6
CI/CD 容器（2GB 内存）：必须压到 4，并加环境变量 COMPOSER_MAX_PARALLEL_HTTP_REQUESTS=4 覆盖
Windows 用户：别碰 8，官方安全上限就是 6，设高了可能触发 ACL 清理误删临时文件

每次改完必须立刻 composer clear-cache，否则旧缓存会复用损坏的句柄，错误照常发生。

多镜像负载均衡必须带 `"canonical": false`

只配一个镜像，再快也扛不住 CI 流水线并发打点；但配多个却不加 "canonical": false，Composer 只认第一个，后面全失效——这是最常被漏掉的字段。

正确写法（放在 composer.json 的 repositories 下）：

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

注意三点：

Discussion Composer

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

下载

每个镜像 URL 末尾必须有 /，少斜杠会拼成 /composerpackages.json 导致 404
不能删掉原始 packagist.org 源，阿里云镜像要求它存在，否则并发设置不生效
验证是否真走多镜像：跑 composer require monolog/monolog -vvv，看日志里 Downloading https:// 的域名是否轮换出现

`repos.packagist.org.concurrent-downloads` 是唯一有效键名

网上很多教程还教用 http-max-concurrent-downloads 或 parallel-downloads，但这两个在 Composer 2.2+ 中已过时或语义错位：parallel-downloads 只控制 dist 包拉取，并发逻辑实际由 repos.packagist.org.concurrent-downloads 驱动。

必须用这个完整键名：

设全局并发为 2：composer config -g repos.packagist.org.concurrent-downloads 2
验证是否生效：composer config -g | grep concurrent 应输出 "concurrent-downloads": 2
如果项目级 composer.json 里写了 repositories，它会覆盖全局配置，得先运行 composer config repo.packagist 确认没冲突

别信“看起来快一点”，要跑 composer install -vvv 看日志里是否真有多个 Downloading https:// 行交错出现——否则只是假并发。

CI/CD 中必须关掉三个干扰项

开发环境有用的参数，在 CI 里全是性能杀手：它们不加速下载，反而拖慢整个流程。

--no-dev：跳过 require-dev 包（如 phpunit），避免测试类污染 autoload classmap
--no-scripts：禁用 post-install-cmd 等钩子，防止意外触发 npm install 或 DB 清理
--no-autoloader：不生成 vendor/autoload.php，后续用 composer dump-autoload --optimize 单独补，避免安装时同步扫描 PSR-4 目录