COMPOSER_DISABLE_NETWORK=1是唯一生效的离线硬开关,必须设置;否则即使断网、加--no-plugins等参数,composer install仍会请求远程元数据而失败。

COMPOSER_DISABLE_NETWORK=1 是唯一生效的离线开关
断网本身不会让 composer install 进入离线模式——它会卡在 Loading composer repositories from packagist.org 或直接报 Could not fetch https://repo.packagist.org/packages.json。真正起作用的只有环境变量 COMPOSER_DISABLE_NETWORK=1,它强制跳过所有 HTTP 请求,包括元数据加载、dist URL 校验、插件远程检查。没有它,--no-plugins、--no-scripts 等参数全无效。
静默安装必须组合三 no + dump-autoload -o
即使 vendor/ 已存在且 composer.lock 完整,composer install 默认仍会重建自动加载器、执行脚本、初始化插件。这些环节可能间接触发网络行为(比如 phpstan/extension-installer 查版本),所以必须显式禁用:
-
--no-plugins:跳过插件初始化,避免隐式联网 -
--no-scripts:屏蔽post-install-cmd,防止调用curl或npm install -
--no-autoloader:绕过 autoload 重建阶段(某些自定义实现会查远程类)
执行完必须立刻补一记:composer dump-autoload -o。否则运行时大概率报 Class not found,因为默认 autoload 映射没生成或不完整。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
全局和项目级 Packagist 配置必须清空
哪怕设了 COMPOSER_DISABLE_NETWORK=1,如果全局或项目配置里还残留 repo.packagist,Composer 会在离线时 fallback 尝试连接镜像源(如阿里云),然后报错退出。验证和清理方式:
- 检查全局配置:
composer config -g repo.packagist,输出应为空或false;不是空就运行composer config --global repo.packagist false - 检查项目配置:
composer config repo.packagist,同理清空 - 若
composer.json中有"repositories": [{"type": "packagist", "url": false}],删掉——它在离线模式下会直接导致命令退出,不是静默忽略
source 类型锁条目会让离线安装必然失败
composer.lock 里只要有一条 "source": {"type": "git", "url": "..."} 或 "dev-master" 这类标记,composer install 就无法离线完成。因为 Composer 需要 clone 或 checkout,而 COMPOSER_DISABLE_NETWORK=1 会直接阻断 Git 协议访问。离线前务必确认:
- 锁文件中所有包的
dist字段都存在且url是本地可解压路径(如zip文件) - 没有
"type": "git"、"type": "svn"或"reference": "..."搭配远程 URL 的组合 - 最稳妥做法:在有网机器上用
composer update --prefer-dist --no-dev生成纯 dist 锁文件
离线安装不是“把 vendor 拷过去就完事”,关键在于锁文件结构、配置残留、命令参数三者必须全部对齐。漏掉任意一个,composer install 就会在某个环节突然报错或卡住,而且错误信息往往不指向真实原因。

















