COMPOSER_DISABLE_NETWORK=1 是离线使用的硬性开关,必须设置才能禁用 Composer 的联网行为;--no-plugins 和 --no-scripts 无法跳过元数据拉取,--offline 参数不存在。

COMPOSER_DISABLE_NETWORK=1 是硬性开关,不设它就必然联网失败
很多用户以为加了 --no-plugins 或 --no-scripts 就能离线,结果仍报 Could not fetch https://repo.packagist.org/packages.json。这是因为 Composer 在 install 阶段第一件事就是拉取元数据,这个行为无法被参数跳过,只能靠环境变量彻底禁用网络通路。
必须在执行前设置:COMPOSER_DISABLE_NETWORK=1。Dockerfile 中写 ENV COMPOSER_DISABLE_NETWORK=1;Linux/macOS 下运行命令前加前缀;Windows CMD 用 set COMPOSER_DISABLE_NETWORK=1 && composer install;PowerShell 用 $env:COMPOSER_DISABLE_NETWORK="1"; composer install。
别信 --offline —— 这个参数根本不存在,是常见误传。
vendor 目录能直接复制,但三件事必须对齐
最省事的离线方案就是把整个 vendor/ 连同 composer.lock 一起拷过去,但以下三点缺一不可:
- 源与目标的 PHP 版本号完全一致(如
8.2.12vs8.2.12,小版本不同也可能因内部 API 变更导致Class not found) - 目标机已启用
mbstring、openssl、zlib等基础扩展(缺一个,vendor/autoload.php就加载失败) -
composer.lock未被修改,且不含"source": {"type": "git"}类条目(例如"url": "git@github.com:xxx/yyy.git")
验证方式:在目标机执行 php -r "require 'vendor/autoload.php';",不报错才算通过。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
离线装新包只能用 path 仓库,require 不行
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,否则不识别) - 必须同步禁用 Packagist:
composer config --global repo.packagist false,并确认composer config repo.packagist输出为空
装完立刻执行 composer dump-autoload -o,否则 autoload.php 不包含该包,运行时必报 Class not found。
最终命令组合不能少这四步
哪怕 vendor/ 已存在、composer.lock 也完整,仍需在目标机跑一遍 install 来校验一致性并重建 autoload。但默认行为仍可能触发插件或脚本,必须显式控制:
- 先设环境变量:
COMPOSER_DISABLE_NETWORK=1 - 跳过插件:
--no-plugins(防止hirak/prestissimo等尝试联网) - 跳过脚本:
--no-scripts(屏蔽post-install-cmd,比如自动执行npm install) - 绕过 autoload 重建:
--no-autoloader(避免残留路径干扰)
执行完必须补一记:composer dump-autoload -o。不加 -o 参数,生成的映射不稳定,尤其在容器或权限受限环境下容易失效。
真正容易被忽略的是:PHP 扩展 ABI 兼容性、composer.lock 中 dist URL 的协议类型(https:// 在禁网后会直接退出)、以及 vendor/ 文件属主 UID/GID 是否匹配容器内运行用户。这些细节不出错,离线部署才算稳。

















