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

必须设 COMPOSER_DISABLE_NETWORK=1,否则 composer install 一定会去请求 https://repo.packagist.org/packages.json 并失败——这不是网络不稳定,是 Composer 默认行为强制校验远程元数据。
为什么 vendor 存在、lock 文件也完整,install 还报错?
错误不是因为文件缺失,而是 Composer 在 install 阶段仍会主动请求远程元数据(比如包是否存在、版本是否合法、dist URL 是否可访问)。这个行为默认开启,且无法跳过,除非显式切断所有网络通路。
-
COMPOSER_DISABLE_NETWORK=1是硬性开关,它让整个依赖解析流程跳过所有 HTTP 请求 - 所有
--no-xxx参数(如--no-plugins、--no-scripts)都依赖它生效;缺了它,这些参数全无效 - 如果项目
composer.json里写了"repositories": [{"type": "packagist", "url": false}],即使设了环境变量也会直接退出,不是静默忽略 - 全局配置残留
repo.packagist(比如之前配过镜像)会导致 fallback 校验,必须运行composer config --global repo.packagist false彻底禁用
离线 install 的最小安全命令组合
前提是:目标机已存在完整 vendor/ 和未改动的 composer.lock,PHP 版本与扩展(mbstring、openssl、zlib)完全一致。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 执行前务必确认:
COMPOSER_DISABLE_NETWORK=1已设为环境变量(Dockerfile 中写ENV COMPOSER_DISABLE_NETWORK=1,Shell 中用export COMPOSER_DISABLE_NETWORK=1) - 运行命令:
composer install --no-interaction --no-plugins --no-scripts --no-dev --no-autoloader - 执行完必须立刻补一记:
composer dump-autoload -o,否则运行时大概率报Class not found - 不要加
--ignore-platform-reqs——它会掩盖扩展缺失问题,让错误延后到运行时才暴露
离线添加新包只能靠 path 仓库
composer require 命令默认必须联网,不查本地缓存,也不尝试复用 ~/.composer/cache/files/ 中的 ZIP。无网络时执行它会直接报错,不是“走缓存”,而是根本不会触发缓存查找。
- 唯一可靠方式是把本地目录当仓库用:把目标包(含合法
composer.json)放到项目内,如./packages/my-utils - 在项目根目录
composer.json中添加:"repositories": [{"type":"path","url":"./packages/my-utils"}] - 运行:
composer require vendor/my-utils:dev-main(注意必须用dev-main这类分支名,path 仓库不认^1.0约束) - 装完立刻执行:
composer dump-autoload,否则autoload.php不包含该包
最容易被忽略的是:COMPOSER_DISABLE_NETWORK=1 必须在进程启动前就生效,不能只在 composer install 命令前临时加;很多 Docker 镜像或 CI 环境因变量未继承导致看似设了实则没用。真离线前,建议先跑 composer diagnose 看 Checking HTTP connectivity 是否明确显示 FAIL。

















