Composer 默认不并发下载是因为其 HttpDownloader 基于 PHP stream_context_create,不支持并行请求,且为保障兼容性、稳定性及服务端压力控制而刻意设计为串行。

composer install 为什么默认不并发下载
因为 Composer 的 HTTP 客户端(HttpDownloader)底层用的是 PHP 的 stream_context_create,它本身不支持真正的并行请求;默认是串行拉取每个包的 composer.json 和 ZIP 包,尤其在依赖多、网络慢时卡得明显。
这不是设计缺陷,而是为了兼容性与稳定性:避免同时开太多连接触发防火墙限流、代理拦截,或让 Packagist 服务端压力过大。官方明确不提供原生多线程开关。
- PHP
cURL扩展必须启用(ext-curl),否则连基础并发优化都用不了 -
allow_url_fopen = Off会导致部分回退逻辑失效,建议保持On - 某些企业内网镜像源不支持
Range请求头,强行并发反而会 416 错误
用 --prefer-dist + 镜像源提速最实际
真正影响安装速度的往往不是“并发数”,而是“要不要 clone Git 仓库”。--prefer-dist 强制走 ZIP 包下载,比 --prefer-source 快 3–10 倍,尤其对 Laravel、Symfony 这类大库。
国内用户必须配镜像源,否则直连 packagist.org 在 DNS 和 TLS 握手阶段就卡住:
- 清华镜像:
composer config -g repo.packagist composer https://packagist.phpcomposer.com(已停用)→ 改用https://mirrors.tuna.tsinghua.edu.cn/composer/ - 阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效:
composer config -g repo.packagist,输出应含https://地址,不是packagist.org
通过 parallel-http 替换默认下载器(需手动集成)
Composer 本身不提供 --threads=4 这种参数,但可以换掉它的 HttpDownloader 实现。社区有个轻量方案:hirak/prestissimo(已归档),现在推荐用 composer-plugin-parallel-downloader。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
它用 cURL multi 批量发请求,把包元数据获取和 ZIP 下载分两轮并发处理:
- 安装插件:
composer global require "kylekatarnls/composer-installers-extender"(非必须)→ 实际只需:composer global require "squizlabs/composer-installer"?不对,直接:composer global require "symfony/flex"是干扰项 —— 正确命令是:composer global require "hirak/prestissimo:^0.4"(PHP 7.4+ 兼容) - 装完后执行
composer install,终端会显示类似Loading composer repositories with package information→ 后面紧跟[2/5] ...进度条,说明已并发 - 如果没反应,检查
~/.composer/composer.json里有没有"hirak/prestissimo",以及是否被COMPOSER_NO_PLUGINS=1环境变量禁用
别碰 fork 版本或 patch 并发数参数
有人改 src/Composer/Util/RemoteFilesystem.php 里的 $concurrent 变量,或者硬编译一个支持 curl_multi 的 PHP SAPI —— 这些操作在 Composer 2.2+ 之后基本无效,因为核心下载逻辑已重构进 Composer\Downloader\DownloadManager,且做了连接池节流。
更危险的是:强行提高并发数(比如设成 20),可能触发 Packagist 的 429 Too Many Requests,导致整个组织 IP 被临时封禁(尤其是用共享出口 IP 的 CI 环境)。
- 真实瓶颈常在磁盘 I/O:解压 ZIP 比下载还慢,
opcache.enable_cli=1对 Composer 自身没用,但能加速后续脚本 - Docker 中运行
composer install时,挂载/tmp到内存盘(tmpfs)比调并发更有效 - CI 场景下,用
composer install --no-interaction --optimize-autoloader --no-progress关掉所有非必要输出和交互,比并发省更多时间
并发下载听着爽,但 Composer 的慢,十次有八次不在网络层。盯紧你的镜像源、关掉 source、确认 cURL 可用,比找“多线程开关”靠谱得多。










