断网时 Composer 默认仍联网校验,必须设 COMPOSER_DISABLE_NETWORK=1 并禁用全局 packagist 源;vendor 存在、lock 完整也不够,还需 --no-plugins --no-scripts --no-autoloader,最后执行 dump-autoload -o。

断网时 Composer 不是“自动离线”,而是默认坚持联网校验——不显式切断网络通路,composer install 必报 Could not fetch https://repo.packagist.org/packages.json。真正能跑通的离线流程,必须提前准备 + 强制隔离 + 严格验证。
为什么 vendor 存在、lock 文件完整,install 还是失败
错误不是因为缺文件,而是 Composer 在 install 阶段仍会主动请求远程元数据:包是否存在、版本是否合法、哈希是否匹配。这个行为默认开启,且无法跳过——除非你明确禁用网络触发点。
-
COMPOSER_DISABLE_NETWORK=1是硬性前提,不设它,所有--no-xxx参数都无效 - 即使
vendor/完整,只要composer.json里写了"repositories": [{"type": "packagist", "url": false}],COMPOSER_DISABLE_NETWORK=1下也会直接退出(不是静默忽略) -
composer.lock中若有"source": {"type": "git"}条目(如dev-master或 Git URL),离线时无法校验,install 必然失败 - 全局配置残留
repo.packagist会导致 fallback 校验,必须运行composer config --global repo.packagist false彻底禁用
离线 install 最稳命令组合
这组参数不是“可选优化”,而是防止意外联网的强制防护。前提是:vendor/ 已存在、composer.lock 未改动、PHP 版本和必需扩展(mbstring、openssl、zlib)完全一致。
-
--no-plugins:跳过插件初始化,避免phpstan/extension-installer等隐式联网 -
--no-scripts:屏蔽post-install-cmd,防止脚本调用外部 API 或生成前端资源 -
--no-autoloader:绕过 autoload 重建,某些自定义实现会触发远程类查找
执行完必须立刻补一记:composer dump-autoload -o,否则运行时大概率报 Class not found。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
离线安装本地包(path 类型)的必要条件
离线时 composer require 会直接报错或卡住,唯一可行路径是把本地目录当仓库用,靠 path 类型跳过所有元数据请求。
- 目标包根目录下必须有合法
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_DISABLE_NETWORK=1和composer config --global repo.packagist false二者缺一不可 - 安装后必须立即运行
composer dump-autoload -o,否则 PSR-4 自动加载规则不会生效
最容易被忽略的兼容性细节
复制 vendor/ 看似最省事,但 PHP 版本微差(如 8.2.12 vs 8.2.13)就可能因内部 API 变动导致 Class not found;含 bin/ 脚本的包(如 phpunit)要求目标机 php 在 $PATH 中,且路径与源环境一致;composer.lock 若被修改过,Composer 会尝试重算依赖,进而触发联网。










