Composer 2.2+ 应使用 composer config -g http-max-concurrent-downloads 10 而非已弃用的 parallel-downloads;必须配合 composer clear-cache 和正确镜像配置(含末尾斜杠)才能生效,否则并发无效。

composer config -g parallel-downloads 10 是核心命令
Composer 2.2+ 默认只并发 3 个 HTTP 连接,对国内带宽严重浪费——哪怕镜像再快,也卡在串行排队。必须显式设置 parallel-downloads,且值建议设为 10(实测 8–12 之间最稳,超过 15 可能触发 CDN 限流或 TLS 握手失败)。
执行:composer config -g parallel-downloads 10
验证是否生效:composer config -g parallel-downloads 输出应为 10,不是空、null 或报错。
- 旧版 Composer(concurrent.http.max-parallel-downloads,但已不推荐
- 该配置仅影响
install/update阶段的 ZIP 包下载,并不加速packages.json元数据拉取(那是单次大请求) - 若项目用了私有 Git 仓库(
"type": "vcs"),并发下载不生效,它仍走git clone单线程
必须搭配 prefer-dist 和 clear-cache 才真正提速
只调并发数不够。默认情况下 Composer 会尝试 source(即 git clone),开销远大于 dist(预编译 ZIP)。生产环境应强制走 dist:
composer config -g prefer-dist true
然后立刻清缓存:composer clear-cache
否则旧缓存里存着 packagist.org 的元数据和 ZIP,镜像和并发全部白配。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
-
prefer-dist true对含大量git@私有源的项目要谨慎,可局部覆盖:"preferred-install": {"mycorp/*": "source"} -
clear-cache必须在改完所有config -g后执行,顺序不能颠倒 - CI 环境中,每次构建前加
composer clear-cache是低成本高回报操作
并发下载卡住时,先看真实请求地址
别猜网络或镜像问题——直接让 Composer 吐出实际发出去的 URL:
composer install -vvv 2>&1 | grep "Downloading\|packages.json"
你应当看到类似:Downloading https://mirrors.aliyun.com/composer/p2/laravel/framework/9.52.0.0.zip
如果出现 packagist.org 或 github.com,说明镜像没生效、项目级 repositories 覆盖了全局,或 parallel-downloads 配置根本没写进当前用户配置。
- 查当前生效配置:
composer config -l | grep "repo\.packagist\|parallel-downloads" - 宝塔、Docker 或 CI 中常以非登录用户(如
www、runner)运行,composer config -g必须切到对应用户下执行 - 并发数调太高(如设成 50)反而易触发 429 Too Many Requests,尤其用腾讯云/阿里云镜像时
项目级临时覆盖比全局更可控
生产发布脚本里,不依赖全局配置,而是用参数临时指定:
composer install --no-dev --prefer-dist --repository-url=https://mirrors.aliyun.com/composer/
这个 --repository-url 会完全忽略所有已配置的仓库(包括项目 composer.json 里的),确保路径绝对干净。
-
--repository-url参数优先级最高,适合 Jenkins、CODING 等 CI 流水线 - 注意:它不接受
--mirror或--repository(后者是旧版拼写,已废弃) - 若项目含私有包,该方式会跳过它们——此时应回退到全局 + 项目级
repositoriesmerge 方案

















