必须设COMPOSER_DISABLE_NETWORK=1,否则composer install必联网校验元数据而失败;离线安装需配合--no-plugins --no-scripts --no-autoloader及后续dump-autoload -o,且须确保PHP环境、composer.lock和vendor一致。

COMPOSER_DISABLE_NETWORK=1 是硬性前提,不设它就必联网
Composer 在断网时执行 composer install 默认会卡在 https://repo.packagist.org/packages.json,哪怕 vendor/ 和 composer.lock 都完整。这不是网络波动问题,而是设计行为:它必须校验远程元数据以确认包存在、版本合法、dist URL 可访问。所有 --no-plugins、--no-scripts、--offline(该参数根本不存在)等参数都无法阻止这一步。
唯一有效方式是提前设置环境变量:COMPOSER_DISABLE_NETWORK=1。它不是“建议开启”,而是强制切断全部 HTTP 请求路径——包括仓库加载、包信息查询、dist URL 检查。没设这个,其他参数全是摆设。
- Linux/macOS:前置写法
COMPOSER_DISABLE_NETWORK=1 composer install ... - Windows CMD:
set COMPOSER_DISABLE_NETWORK=1 && composer install ... - PowerShell:
$env:COMPOSER_DISABLE_NETWORK="1"; composer install ...
离线 install 的最小安全命令组合
前提是目标机已存在未改动的 composer.lock 和结构完整的 vendor/,且 PHP 版本、必需扩展(mbstring、openssl、zlib)完全一致。
推荐执行:
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
--no-plugins:跳过插件初始化,避免symfony/flex或phpstan/extension-installer等隐式联网 -
--no-scripts:屏蔽post-install-cmd,防止触发npm install或生成前端资源等外联行为 -
--no-autoloader:绕过 autoload 重建阶段,某些自定义 autoloader 实现会尝试远程类查找(真实存在但少见)
执行完必须立刻补一记:composer dump-autoload -o。否则运行时大概率报 Class not found —— 因为默认 autoload 映射不会自动包含已有 vendor 中的类路径,尤其 PSR-4 规则下。
离线添加新包只能靠 path 仓库
composer require 在断网下必然失败,它不查本地缓存,也不支持离线解析依赖树。唯一可靠方式是把本地目录当仓库用。
- 目标包根目录下必须有合法
composer.json,含完整name(如"acme/utils")和明确version(如"1.2.0")或分支标识(如"dev-main") - 项目
composer.json的repositories段显式声明:{"type":"path","url":"./packages/my-utils"} - 执行
composer require acme/utils:@dev(注意必须带@dev,否则不识别) - 安装后必须立即运行
composer dump-autoload -o,否则 PSR-4 自动加载规则不会生效
还要同步禁用全局 Packagist:composer config --global repo.packagist false;检查项目级配置:composer config repo.packagist 输出应为空,不能是 composer https://packagist.org。
最容易被忽略的三个致命点
即使你设了 COMPOSER_DISABLE_NETWORK=1 并跑通了 install,以下三点仍可能让整个流程在运行时崩溃:
-
composer.lock中存在"source": {"type": "git"}条目(比如"dev-master"或 GitHub URL),离线无法校验,install 必然失败 - 项目
composer.json或全局配置里残留"repositories": [{"type": "packagist", "url": false}],会在COMPOSER_DISABLE_NETWORK=1下直接退出,不是静默忽略 - 目标机缺失必需扩展(如
mbstring),--ignore-platform-reqs会掩盖问题,错误延后到运行时才暴露,且难以定位










