COMPOSER_DISABLE_NETWORK=1是唯一生效的离线硬开关,不设则composer install必报Could not fetch packages.json;必须前置设置环境变量,配合--no-plugins --no-scripts --no-autoloader及dump-autoload -o,且需清理repo.packagist配置、避免source类型包。

COMPOSER_DISABLE_NETWORK=1 是唯一生效的离线开关,不设它,所有“离线操作”都会在第一步就失败——报 Could not fetch @#@#@#@#@#@#@#@#@#@0。
为什么 vendor 都拷过去了,composer install 还报错?
不是文件没拷全,是 Composer 默认仍会联网校验元数据,这个行为无法跳过,除非硬性切断网络通路。
-
COMPOSER_DISABLE_NETWORK=1必须前置设置,Linux/macOS 用COMPOSER_DISABLE_NETWORK=1 composer install;Windows CMD 用set COMPOSER_DISABLE_NETWORK=1 && composer install;PowerShell 用$env:COMPOSER_DISABLE_NETWORK="1"; composer install - 即使
vendor/和composer.lock完整,只要全局配置里还留着repo.packagist(比如阿里云镜像),就会 fallback 失败,必须执行composer config --global repo.packagist false -
composer.lock里不能有"source": {"type": "git"}或"dev-master"这类条目,否则离线时无法校验,install 直接退出
离线 install 最稳命令组合
这组参数不是“可选优化”,而是防止插件、脚本、autoload 环节隐式触发网络调用的强制防护。
-
--no-plugins:跳过phpstan/extension-installer等插件初始化(它们可能查远程版本) -
--no-scripts:屏蔽post-install-cmd,避免执行npm install或 curl 请求 -
--no-autoloader:绕过 autoload 重建阶段(某些自定义加载器会尝试远程类查找) - 执行完必须立刻补一记:
composer dump-autoload -o,否则运行时大概率Class not found
完整命令示例:COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader && composer dump-autoload -o
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
离线添加新包只能走 path 仓库
composer require 默认必须联网查包名、版本、依赖树,离线不可用。唯一可靠路径是把本地目录当仓库用。
- 目标包根目录下必须有合法
composer.json,含完整"name"(如"acme/utils")和"version"或分支标识(如"dev-main") - 项目
composer.json的repositories段显式声明:{"type":"path","url":"./packages/my-utils"} - 执行
composer require acme/utils:@dev—— 注意必须带@dev,否则不识别 - 装完必须立即运行
composer dump-autoload -o,否则 PSR-4 规则不会生效
最容易被忽略的三件事
很多团队在联网机上跑完 install 就直接拷 vendor/,结果离线机上 require 'vendor/autoload.php' 就报错,问题往往卡在这三点:
- PHP 版本小版本不一致(如 8.3.12 vs 8.3.11),内部 API 变更会导致
Class not found - 目标机缺
mbstring、openssl、zlib中任一扩展,autoload.php加载直接失败 - 用了
composer create-project初始化项目——它天生强制联网,COMPOSER_DISABLE_NETWORK=1对它完全无效
离线不是“断网就行”,是得提前清理配置、校验锁文件结构、绕过所有高风险环节。漏掉任意一个,composer install 就会在 Loading composer repositories 那步卡死或退出。










