断网安装失败主因是未设COMPOSER_DISABLE_NETWORK=1,该环境变量为硬开关,不设则所有--no-xxx参数无效;vendor和lock存在仍报错因Composer默认强制联网校验元数据,必须显式禁用网络并配合--no-plugins、--no-scripts、--no-autoloader及dump-autoload -o。

断网安装失败,99% 是因为没设 COMPOSER_DISABLE_NETWORK=1,而不是网络真断了就自动离线——这个环境变量是硬开关,不设它,所有 --no-xxx 参数都无效。
为什么 vendor 和 lock 都在,composer install 还报 “Could not fetch packages.json”?
错误不是文件缺失,而是 Composer 默认会联网校验包元数据(比如版本是否存在、是否被废弃),哪怕 vendor/ 已存在、composer.lock 完整,它仍会尝试请求 https://repo.packagist.org/packages.json。这个行为无法跳过,除非显式切断网络通路。
-
COMPOSER_DISABLE_NETWORK=1必须提前设置:Linux/macOS 用export COMPOSER_DISABLE_NETWORK=1;Windows PowerShell 用$env:COMPOSER_DISABLE_NETWORK="1";CMD 用set COMPOSER_DISABLE_NETWORK=1,且需在当前终端生效 - 只改
composer.json里的"secure-http": false或加--no-network(该参数根本不存在)毫无作用 - 如果
composer.json中有自定义仓库(如"repositories": [{"type": "packagist", "url": false}]),COMPOSER_DISABLE_NETWORK=1下会直接退出,不是静默忽略
离线 install 命令必须带哪些参数?
光设环境变量还不够,还得组合使用防护参数,否则插件、脚本或 autoload 重建环节仍可能触发隐式联网。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
--no-plugins:跳过插件初始化,避免phpstan/extension-installer等插件发起远程请求 -
--no-scripts:屏蔽post-install-cmd,防止脚本调用外部 API 或生成配置时出错 -
--no-autoloader:绕过 autoload 重建,某些自定义 autoloader 实现会尝试远程类查找 - 执行完必须立刻补一记
composer dump-autoload -o,否则运行时大概率报Class not found
哪些情况离线 install 必然失败?
即使环境变量和参数全对,以下情形也会导致离线安装直接中断,得提前检查。
-
composer.lock中存在"source"类型依赖(如"dev-master"或 Git URL),离线时无法校验 commit hash,install 必然失败 - 全局配置残留
repo.packagist(比如之前设过镜像但没禁用),会 fallback 到远程校验,必须运行composer config --global repo.packagist false彻底关掉 - 项目里用了私有包且
composer.json写的是git@github.com:user/repo.git,SSH 协议在离线时无法解析,应提前统一改为 HTTPS 克隆地址
最易被忽略的一点:离线模式下,composer install 不再校验 PHP 版本和扩展兼容性,但 composer dump-autoload -o 仍依赖 mbstring、zlib 等扩展真实可用——别只信 phpinfo() 页面,要用 php -m | grep -E "mbstring|zlib|openssl" 在 CLI 下实测。

















