断网时composer install默认失败,必须设COMPOSER_DISABLE_NETWORK=1强制离线,否则仍会请求https://repo.packagist.org/packages.json;该变量是硬性开关,不设则所有--no-xxx参数无效,且需配合--no-plugins --no-scripts --no-autoloader及后续dump-autoload -o。

断网时 composer install 默认会失败,不是“自动离线”,而是必须显式切断所有网络通路并绕过校验环节——否则哪怕 vendor/ 和 composer.lock 都完整,也会卡在 Could not fetch https://repo.packagist.org/packages.json。
必须设 COMPOSER_DISABLE_NETWORK=1 才算真正离线
这个环境变量是硬性开关,不设它,所有 --no-xxx 参数都无效。Composer 不会因为物理断网就自动跳过元数据请求,它仍会尝试 DNS 解析、TLS 握手,最终报 Curl error 60 或 Connection refused。
- Linux/macOS:执行前加
export COMPOSER_DISABLE_NETWORK=1,或直接写成COMPOSER_DISABLE_NETWORK=1 composer install ... - Windows CMD:
set COMPOSER_DISABLE_NETWORK=1 && composer install ... - PowerShell:
$env:COMPOSER_DISABLE_NETWORK="1"; composer install ... - 检查是否生效:运行
composer config --global repo.packagist,输出应为空;若仍是{"type": "composer", "url": "https://packagist.org"},说明没禁掉全局源,需补composer config --global repo.packagist false
composer install 离线执行的最小安全参数组合
光有 COMPOSER_DISABLE_NETWORK=1 不够,composer.lock 里若有 "source" 类型包(比如 Git URL 或 dev-master),install 仍会失败。所以必须配合参数强制跳过高风险环节:
-
--no-plugins:防止插件(如symfony/flex或phpstan/extension-installer)初始化时联网 -
--no-scripts:跳过post-install-cmd,避免触发npm install或远程 API 调用 -
--no-autoloader:绕过 autoload 重建阶段,某些自定义加载器会在该阶段做远程类探测 - 执行完必须立刻补
composer dump-autoload -o,否则运行时大概率报Class not found
离线添加新包只能靠 path 仓库 + @dev
composer require 在断网下必然失败,它根本不会查本地缓存,也不支持离线解析依赖树。唯一可行路径是把目标包当本地仓库用:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 包目录必须含合法
composer.json,且name和version(或dev-main这类分支名)明确 - 项目
composer.json中加:"repositories": [{"type": "path", "url": "./packages/my-utils"}] - 执行
COMPOSER_DISABLE_NETWORK=1 composer require vendor/name:@dev(注意必须带@dev,^1.0会被拒绝) - 安装后立即
composer dump-autoload -o,否则 PSR-4 自动加载规则不生效
复制 vendor 是最简方案,但有隐藏前提
直接 tar -czf vendor.tgz vendor/ 再解压到目标机,确实快,但容易在运行时崩溃:
- PHP 版本必须完全一致(8.2.12 ≠ 8.2.13),否则 OPcache 或内部 API 微变会导致
Class not found - 所有扩展(
mbstring、openssl、zlib、curl)必须已启用,composer install --ignore-platform-reqs会掩盖问题,让错误延后爆发 -
composer.lock必须一并拷贝且未被修改,否则vendor/中实际版本可能与 lock 不匹配 - 含
bin/脚本的包(如phpunit)要求目标机php在$PATH中,且路径与源环境一致
真正难的不是命令怎么写,而是判断哪些环节能跳过、哪些必须保留——比如 --no-autoloader 看似省事,但漏掉 dump-autoload -o 就等于白干;又比如 path 仓库写了却忘了设 COMPOSER_DISABLE_NETWORK=1,结果还是连 Packagist。










