离线环境使用Composer必须显式禁用网络并提前就位所有依赖元数据和文件,否则必报“Could not fetch https://repo.packagist.org/packages.json”;需设COMPOSER_DISABLE_NETWORK=1、执行composer config --global repo.packagist false、用artifact/path仓库、清空vendor后运行composer install --no-plugins --no-scripts --no-autoloader,再补dump-autoload -o。

离线环境使用 Composer 不是“配几个选项就能跑”,而是必须切断所有网络触发点,并让所有依赖元数据和文件提前就位。不满足这两条,composer install 一定会卡在 Could not fetch https://repo.packagist.org/packages.json。
必须禁用 packagist.org 的 fallback 行为
只改 repositories 或加镜像源不够,Composer 默认仍会尝试访问 repo.packagist.org 校验包是否存在。全局配置必须显式关闭它:
-
composer config --global repo.packagist false(关键!不是repos.packagist) - 检查项目级配置:
composer config repo.packagist输出应为空,不能是composer https://packagist.org - 删掉
composer.json中任何残留的{"type":"composer","url":"https://packagist.org"}条目 - 若执行
composer install -v仍看到Downloading https://repo.packagist.org/packages.json,说明某处没清干净
必须指定本地仓库类型并确保路径可读
仅靠 file:// URL 指向静态 packages.json 不够稳定;推荐用 artifact 或 path 类型,它们完全跳过 HTTP 请求:
-
artifact:适合部署,要求所有包是vendor/name-version.tar.gz格式,放在单层目录(如/opt/artifacts/),再运行:composer config --global repositories.offline '{"type":"artifact","url":"/opt/artifacts/"}' -
path:适合开发联调,本地包目录下必须有合法composer.json(含name和version或dev-main),然后在项目composer.json中写:{"type":"path","url":"./packages/my-lib"},再composer require vendor/name:dev-main - Windows 下
path的url必须带盘符,如C:/projects/my-pkg,且斜杠方向要一致
必须设 COMPOSER_DISABLE_NETWORK=1 并限制 install 行为
这个环境变量是硬性开关,不设它,所有 --no-xxx 参数都无效:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 执行前必须先设:
export COMPOSER_DISABLE_NETWORK=1(Linux/macOS)或set COMPOSER_DISABLE_NETWORK=1(Windows) - install 命令必须带:
composer install --no-plugins --no-scripts --no-autoloader - 即使
vendor/已存在,也必须删空再跑,否则可能混入旧包导致 autoload 冲突 - 执行完立刻补:
composer dump-autoload -o,否则运行时大概率报Class not found
必须确保 composer.lock 与本地文件严格匹配
离线安装成败取决于 composer.lock 中每个包的 dist.shasum 能否在本地找到对应 ZIP 或 TAR 文件:
-
lock文件必须由联网机生成,且不能改动——哪怕改一个空格,shasum就失效 - 如果
lock里某个包是"source"类型(如"url": "git@github.com:..."),离线时无法校验,install必然失败 - 验证方式:检查
lock中某项的dist.url是否指向本地路径,dist.shasum是否能在你配置的artifact目录下找到对应文件 - PHP 版本、扩展(
ext-zip、ext-openssl)必须与生成lock的机器一致,否则解压或校验阶段直接退出
最容易被忽略的是:禁用 packagist 后,composer install 仍可能因 repositories 配置中残留无效 URL 或权限问题(如 cache-dir 不可写)而静默失败——建议用 -v 参数看真实行为,而不是只盯最终报错。










