Composer 2.2+才真正支持parallel-downloads,需全局配置(composer config -g parallel-downloads 10)、配合国内镜像、--prefer-dist及清缓存才能生效;验证方式为composer install -vvv观察是否并发出现多条Downloading日志。

Composer 2.2+ 才真正支持 parallel-downloads,且必须全局配置、配合镜像源和 --prefer-dist 才能生效;低于 2.2 的版本设了也白搭,别浪费时间。
怎么确认 parallel-downloads 配置已生效
它不是默认开启的,也不是项目级配置——不查就不知道有没有真起作用。
- 执行
composer config -g parallel-downloads,输出应为具体数字(如10),空值或报错说明没设或版本太低 - 运行
composer install -vvv,观察日志是否出现多条Downloading https://mirrors.aliyun.com/并发请求行,而不是一行卡住等很久才跳下一条 - 若
composer diagnose仍提示hirak/prestissimo,说明插件残留,必须先执行composer global remove hirak/prestissimo
parallel-downloads 设多少才合适
并发数不是越高越好,它直接受限于本地临时文件系统、镜像源限流策略和 PHP 进程调度能力。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 推荐从
10开始:多数 Linux/macOS CI 环境稳态表现最佳 - 设到
15或更高后出现file_put_contents(/tmp/): failed to open stream,基本是临时文件竞争,立刻降到6或8 - 阿里云/腾讯云镜像对并发敏感,超过
12容易触发429 Too Many Requests,尤其在 CI 高频调用场景 - Windows 上因 Defender 实时扫描 + NTFS fsync 延迟,建议不超过
6
为什么开了 parallel-downloads 还是卡在 downloading
并发只是“同时发请求”,但每个请求卡在哪,parallel-downloads 完全不管。
- 镜像没切成功:执行
composer config -g repo.packagist必须输出https://mirrors.aliyun.com/composer/,空值或null说明配置失败 - 缓存没清:旧缓存里存着 packagist.org 的元数据,下载时仍会 fallback 回源,必须执行
composer clear-cache - 项目级配置覆盖:如果
composer.json里有"prefer-source": true,prefer-dist就不生效,parallel-downloads下载的仍是慢速 Git clone 流程 - 命令漏参数:
composer install默认不启用并行逻辑,必须显式加--prefer-dist(或全局设prefer-dist true)才能触发 dist 包并发下载
parallel-downloads 和 http-max-concurrent-downloads 到底用哪个
两个参数都存在,但作用范围和生效条件完全不同,混用反而容易失效。
-
parallel-downloads是 Composer 2.2+ 引入的正式配置项,控制 dist 包下载并发数,只对install有效,update不走这条路 -
http-max-concurrent-downloads是底层 HTTP 请求池大小,影响所有网络操作(包括元数据拉取),但它在 2.2+ 中已被弱化,设了也不影响 dist 并发主流程 - 当前最简组合:只设
parallel-downloads,配镜像,清缓存,加--prefer-dist—— 其它参数优先级低,除非你明确遇到 TLS 握手瓶颈或 DNS 解析延迟,否则别碰
真正拖慢 Composer 的,从来不是单个包下载慢,而是串行等待 + fallback 到 source + 镜像未生效这三者叠加。调并发只是最后一环,前面任一环节没对,parallel-downloads 就只是个摆设。

















