必须设COMPOSER_DISABLE_NETWORK=1,否则所有离线命令均无效;该变量是硬性开关,强制跳过全部HTTP请求,使--no-plugins等参数生效,缺一则composer install必报“Could not fetch packages.json”错误。

必须设 COMPOSER_DISABLE_NETWORK=1,否则所有命令都无效
离线环境下,composer install 默认会尝试访问 https://repo.packagist.org/packages.json,哪怕 vendor/ 已存在、composer.lock 也完整,只要没设这个环境变量,就一定会卡住或报错 Could not fetch packages.json。这不是网络不稳定,是 Composer 的硬性行为。
这个变量是全局开关:它让整个依赖解析流程跳过所有 HTTP 请求,包括仓库元数据加载、包信息查询、dist URL 检查。所有 --no-xxx 参数(比如 --no-plugins)都依赖它生效——缺了它,参数全白搭。
常见误操作:
- 只加
--no-plugins --no-scripts,但没设环境变量 → 仍失败 - 项目
composer.json里还留着"repositories": [{"type": "packagist", "url": "https://packagist.org"}]→ 即使设了变量也会直接退出 - 全局配置残留镜像源:
composer config --global repo.packagist输出不是false→ 必须先运行composer config --global repo.packagist false
composer require 在离线时根本不能用
composer require 默认要联网查包名是否存在、校验版本兼容性、确认 dist URL 是否可访问。离线状态下,它连第一步都过不去,直接报错 Could not find package 或卡在 DNS 解析。
唯一可行的离线“添加新包”方式,是用 path 类型仓库:
- 本地包根目录下必须有合法
composer.json,含完整"name"(如"acme/utils")和"version"或分支标识(如"dev-main") - 项目
composer.json中声明仓库:"repositories": [{"type": "path", "url": "./packages/my-utils"}],路径必须相对、可移植,不能是/home/user/... - 执行
composer require acme/utils:@dev,注意必须带@dev,否则 Composer 不认本地路径 - 同时确保
options: {"symlink": false}已写进仓库配置,避免离线机上软链失效
离线安装依赖只能靠 vendor/ + composer.lock 组合
离线部署不是“不用网络”,而是“不依赖远程仓库”。核心前提是:所有包必须提前下载好,且 composer.lock 必须存在、未被修改、与目标 PHP 环境兼容。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
安全命令组合(在目标离线机上执行):
COMPOSER_DISABLE_NETWORK=1 composer install --no-interaction --no-plugins --no-scripts --no-dev --optimize-autoloader
关键点说明:
-
--no-interaction:禁用任何交互提示(如 license 确认),避免卡住 -
--no-plugins:防止插件(如hirak/prestissimo)初始化时尝试联网 -
--no-scripts:跳过post-install-cmd,避免脚本调用 npm 或外部 API -
--optimize-autoloader:强制重建vendor/autoload.php,否则运行时大概率报Class not found - 执行完必须立刻补一记:
composer dump-autoload -o,否则 autoload 映射可能不全
直接复制 vendor/ 目录行不行?要看这三件事
可以,但风险高,容易出 Class not found 或扩展缺失错误。是否能直接复制,取决于源与目标环境是否真正一致:
-
PHP版本必须完全一致(如8.2.12vs8.2.13都可能因内部 API 微变导致失败) - 所有扩展必须已启用:
ext-mbstring、ext-openssl、ext-zip(解压必需)、ext-json缺一不可 -
composer.lock必须一并拷贝,且不能被修改;否则composer install会尝试重算依赖,触发联网
验证方式:在源环境跑一遍 composer install --no-dev --optimize-autoloader,再用相同 PHP SAPI(CLI/FPM)require 'vendor/autoload.php' 测试能否正常加载;目标机做同样测试。
最容易被忽略的是 ext-zip —— 它不是 Composer 运行必需,但却是解压 .zip 包的硬依赖。离线机没装,composer install 会静默跳过某些包,直到运行时报错。

















