必须设 COMPOSER_DISABLE_NETWORK=1 才算真正断网,否则 composer install 会访问 packagist 并报错;需确保 composer.lock 中目标包为 dist 类型且版本固化,最后执行 composer dump-autoload -o。

断网安装指定版本不是“断掉网络就能自动离线”,而是必须提前设好隔离条件、显式禁用所有联网路径,否则 composer install 一启动就会去抓 https://repo.packagist.org/packages.json 并报错。
必须设 COMPOSER_DISABLE_NETWORK=1 才算真正断网
这个环境变量是硬性开关,不设它,后面所有 --no-xxx 参数都无效。它不是“建议开启”,而是“不设就失败”的前提。
- Linux/macOS:运行前加
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader - Windows(CMD):先执行
set COMPOSER_DISABLE_NETWORK=1,再跑 install 命令 - PowerShell:用
$env:COMPOSER_DISABLE_NETWORK="1" - 别依赖“物理断网”——Composer 会检测 DNS 或 fallback 到全局 repo 配置,哪怕网线拔了也照样报错
composer.json 里不能有 "repositories" 指向 packagist
哪怕只写了一行 {"type": "packagist", "url": false},在 COMPOSER_DISABLE_NETWORK=1 下也会直接退出,不是静默跳过。
- 检查主项目
composer.json,删掉或注释掉整个repositories字段 - 全局配置残留更危险:运行
composer config --global repo.packagist false彻底关掉 fallback - 如果用了 path 仓库(比如本地包),确保它类型是
"type": "path",且路径真实存在、可读
指定版本必须已存在于 composer.lock,且不能是 source 类型
你想装的 vendor/package:1.2.3,得已经在 lock 文件里固化,且 source.type 是 dist。如果是 "source": {"type": "git", ...},离线时无法校验 commit,install 必然失败。
- 验证方法:打开
composer.lock,搜该包名,确认"version": "1.2.3"和"source": {"type": "dist"} - 如果 lock 里是
"dev-main"或长 commit hash,说明之前没锁死版本,得先联网跑一次composer update vendor/package --with-all-dependencies再备份 lock - 本地 path 包要生效指定版本,其自身
composer.json必须含"version": "1.2.3",且主项目config段设"symlink": false
最后一步不能漏:composer dump-autoload -o
composer install --no-autoloader 跳过了 autoload 重建,但 vendor 目录里没有 vendor/autoload.php 或类映射不全,运行时必报 Class not found。
- 这步必须在 install 之后立刻执行,且不能加
--no-autoloader - 加
-o(optimize)能生成静态映射,比默认快,也更稳定 - 如果项目用了自定义 autoload 规则(如 PSR-0/4 映射),确保
composer.json的autoload段没调用任何远程逻辑
最容易被忽略的是:composer.lock 里某个包的 source.reference 是长 commit hash,表面看是 1.2.3,实际拉的是 dev 分支快照——这种“假指定版本”在离线环境下完全不可靠,必须从源头确保 lock 文件真实反映 dist 发布态。


















