必须设COMPOSER_DISABLE_NETWORK=1,否则composer install必访https://repo.packagist.org/packages.json而卡住或报错;该变量是硬性开关,所有--no-xxx参数均依赖它生效,缺一则离线模式失效。

断网 ≠ 离线模式生效,不设 COMPOSER_DISABLE_NETWORK=1,所有“离线操作”都白搭。
为什么 composer install 还是报 Could not fetch https://repo.packagist.org/packages.json?
Composer 不会因为网络不通就自动跳过元数据请求——它默认坚持发请求,直到超时或失败。这个行为无法靠删配置、改 composer.json 或加 --no-xxx 参数绕过。
-
COMPOSER_DISABLE_NETWORK=1必须在命令执行前显式设置,且对当前 shell 生效(Linux/macOS 用export COMPOSER_DISABLE_NETWORK=1,Windows PowerShell 用$env:COMPOSER_DISABLE_NETWORK="1") - 别信
--offline或--no-network:这些参数根本不存在,Composer 会静默忽略 - 即使
vendor/和composer.lock都齐全,只要没设这个环境变量,install仍会卡在远程包列表校验环节 - 全局配置残留也会干扰:运行
composer config --global repo.packagist false彻底禁用 Packagist fallback
vendor/ 直接复制过去,为什么运行时报 Class not found?
复制 vendor/ 是最快方案,但 PHP 环境稍有差异就会在运行时崩,而不是安装时失败。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- PHP 版本必须完全一致(如
8.3.12vs8.3.12,小版本不同也可能因内部 API 变更导致 autoload 失败) - 必需扩展缺一不可:
mbstring、openssl、zlib必须已启用,否则vendor/autoload.php自身就 require 失败 -
composer.lock里不能含"source": {"type": "git"}或"dev-master"类条目——离线机无法校验这类来源 - 验证方式很简单:在目标机执行
php -r "require 'vendor/autoload.php';",不报错才算真正通过
离线加新包,为什么 composer require 一定失败?
composer require 设计上就必须联网查包名、版本、依赖树,离线场景下它连解析第一步都走不完。
- 唯一可行路径是用
path仓库类型:把本地包目录(含合法composer.json)当私有源用 - 项目
composer.json中必须声明:{"type":"path","url":"./packages/my-utils"},且url是相对路径 - 执行时必须带
@dev标识:composer require acme/utils:@dev,否则不识别本地路径包 - 必须同步禁用 Packagist:
composer config --global repo.packagist false,否则仍会 fallback 查询 - 装完立刻跑
composer dump-autoload -o,否则 PSR-4 映射不会生效,class_exists()返回false
执行 composer install 时还该关哪些开关?
即使网络已切断,插件、脚本、autoload 重建等环节仍可能触发隐式依赖或路径错误。
-
--no-plugins:防止hirak/prestissimo或symfony/flex尝试初始化网络组件 -
--no-scripts:跳过post-install-cmd,避免执行npm install或生成前端资源等意外动作 -
--no-autoloader:先绕过 autoload 重建,避免因旧缓存或路径残留出错 - 最后必须补一记
composer dump-autoload -o,-o强制生成优化映射,比默认散列更稳定 - 完整命令示例:
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader && composer dump-autoload -o
最容易被忽略的点:环境变量设置只对当前 shell 有效;Dockerfile 里要用 ENV,CI 脚本里要确保每步都继承该变量,否则中间某步失效,整个流程就卡在元数据请求上。

















