COMPOSER_DISABLE_NETWORK=1本身不加速编译,但能消除网络重试、超时和fallback等不可控延迟,使install从可能卡住几十秒变为稳定几秒完成;其提速主因是跳过远程元数据请求、dist URL校验及插件隐式联网。

COMPOSER_DISABLE_NETWORK=1 配置本身不加速编译,但它能避免因网络失败导致的重试、超时和静默 fallback,让 composer install 从“可能卡住几十秒甚至失败”变成“稳定在几秒内完成”——这不是提升 CPU 速度,而是消除不确定性。
为什么离线配置后 install 看起来“快了”
实际耗时下降主因是跳过了三类阻塞操作:
- 不再尝试请求
https://repo.packagist.org/packages.json(典型失败:cURL error 7 或 28,超时 30s) - 跳过对每个包 dist URL 的 HEAD 请求校验(尤其当 lock 文件里有
https://开头的 url 字段时) - 绕过插件自动初始化引发的隐式网络调用(如
phpstan/extension-installer会查 GitHub API)
这些不是“慢”,而是“不可控延迟”。你看到的“5 秒 vs 45 秒”,差的不是 Composer 解析能力,是它反复撞墙的时间。
composer install 在离线模式下真正花时间在哪
一旦 COMPOSER_DISABLE_NETWORK=1 生效且缓存/lock/vendor 齐备,剩余耗时几乎全来自本地文件操作:
- 读取
composer.lock并校验 hash(毫秒级) - 检查
vendor/下每个包的installed.json是否匹配 lock(O(n) 文件 stat) - 复制或解压
cache-files-dir下的 ZIP 包(I/O 密集,取决于磁盘速度) - 生成
vendor/autoload.php(若没加--no-autoloader)
注意:--no-autoloader 不影响依赖安装逻辑,只跳过 autoload 文件重建。但漏掉这步,后续 composer dump-autoload -o 会单独再跑一遍,反而拉长总时间。
实测对比的关键陷阱
很多人拿“联网机执行一次 install”和“离线机执行一次 install”比速度,结果无效,因为:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 联网机首次运行会触发完整解析 + 下载 + 解压 + autoload,而离线机只是复用已有 ZIP 和 lock —— 这不是同一件事
- 没清空
~/.composer/cache就测联网机,实际走的是本地缓存,虚高了“联网”表现 - 离线机若
cache-files-dir指向错误路径(比如少了/files后缀),Composer 会静默 fallback 到重下 ZIP,你以为离线,其实还在等网络超时 - 没加
--no-plugins,某些插件会在 install 后阶段发起网络请求(如发送匿名使用统计),导致命令卡住但无报错
真正可比的场景只有一种:同一台机器,先设 COMPOSER_DISABLE_NETWORK=1,再删掉 vendor/ 和 composer.lock,然后用预下载好的 cache-files-dir 目录,跑两次 composer install --no-plugins --no-scripts --no-autoloader —— 第二次才反映纯本地 I/O 成本。
离线配置最常被忽略的性能瓶颈
配置对了,不代表就快。以下三点不处理,离线 install 仍可能卡在 10s+:
-
cache-files-dir所在文件系统是 NFS 或低速 USB 盘,解压 ZIP 时 I/O 等待拉长整体时间 - PHP 的
memory_limit小于 512M,composer install在处理大 lock 文件时会反复 GC,表现为 CPU 占满但进度不动 - 项目用了大量
"type": "path"仓库,Composer 会对每个 path 目录执行is_dir()+file_exists("composer.json"),路径层级深或数量多时显著拖慢
离线不是终点,而是把问题从“网络不可靠”转向“本地路径与权限是否真实可用”。很多团队测出“离线比在线还慢”,最后发现是 cache-files-dir 目录属主为 root,而 PHP 进程以 www-data 身份运行,每次 stat 都要权限降级检查。










