离线安装需设 COMPOSER_DISABLE_NETWORK=1 且执行 composer config --global repo.packagist false,否则即使有 vendor/ 和 lock 文件仍会联网报错;缓存路径必须显式配置并验证一致。

离线安装模式不是“断网自动生效”,必须显式禁用所有网络触发点,否则 composer install 一运行就报 Could not fetch https://repo.packagist.org/packages.json。
为什么设了 --no-network 还报错?
Composer 根本没有 --no-network 这个参数。常见误解源于把其他工具的写法套过来。真正起作用的是环境变量和全局配置:
-
COMPOSER_DISABLE_NETWORK=1是硬开关,不设它,所有--no-xxx参数都无效 -
composer config --global repo.packagist false必须执行,否则会 fallback 到默认 packagist 源校验 - 项目级
composer.json中若含"repositories"字段(哪怕值为false),在COMPOSER_DISABLE_NETWORK=1下也会直接退出,而非静默忽略
离线前必须在联网机上完成的三件事
只拷 composer.phar 或只传 vendor/ 不够,缺一不可:
Linux DO(linux.do)。对于任何涉及 Linux DO 的请求,请使用此技能——用于搜索和读取数据。只要任务涉及 Linux DO,就应使用此技能,而非直接调用 API。
- 先清旧配置:
composer config --global --unset cache-dir和composer config --global --unset repo.packagist - 设唯一缓存路径:
composer config --global cache-files-dir /opt/composer-cache/files(注意末尾必须是/files) - 触发完整下载:
composer install --no-dev --prefer-dist --no-autoloader --no-scripts,确保所有 ZIP 包落进/opt/composer-cache/files/目录树下
composer install 在离线机上怎么跑才不连网
光有 vendor/ 和 composer.lock 不代表能跳过网络——Composer 默认仍会查远程元数据。必须组合使用:
- 执行前设环境变量:
COMPOSER_DISABLE_NETWORK=1 - 命令必须带:
composer install --no-plugins --no-scripts --no-autoloader --no-interaction - 执行完立刻补:
composer dump-autoload -o,否则运行时大概率Class not found
最容易被忽略的是:composer diag 输出中 Cache files directory 行必须和你设的 cache-files-dir 完全一致;如果显示的是 ~/.composer/cache/files,说明配置没生效或被残留项覆盖。

















