断网容器中直接运行composer install必然失败,因其默认联网校验packages.json、包存在性、版本合法性及dist URL可达性,即使vendor和composer.lock完整;必须设COMPOSER_DISABLE_NETWORK=1硬关闭网络,否则--no-plugins或拔网线均无效。

断网容器里直接跑 composer install 必然失败,不是“配个镜像源”就能绕过去的事——它默认会查 https://repo.packagist.org/packages.json,哪怕 vendor/ 已存在、composer.lock 也完整。
为什么 vendor 存在还报 Could not fetch packages.json
错误不是因为文件没拷全,而是 Composer 在 install 阶段仍要联网校验元数据:包是否存在、版本是否合法、dist URL 是否可访问。这个行为默认开启,且无法跳过,除非你彻底切断所有网络触发点。
-
COMPOSER_DISABLE_NETWORK=1是硬开关,不设它,加--no-plugins或拔网线都没用 - 项目
composer.json里若写了"repositories"块(哪怕"url": false),也会导致直接退出而非静默忽略 -
composer.lock中若有"source": {"type": "git"}条目(比如dev-main),离线时无法校验,install 必然失败
Dockerfile 多阶段构建:唯一稳的离线方案
核心思路是“有网环境预装,无网环境只搬运”,不把网络逻辑带进最终镜像。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 第一阶段用带网络的 builder 镜像(如
php:8.2-cli):RUN composer install --no-dev --no-scripts --optimize-autoloader - 第二阶段用精简运行镜像(如
php:8.2-fpm-alpine):COPY --from=builder /app/vendor /var/www/html/vendor - 务必加
--no-scripts:避免某些包的post-install-cmd触发 npm install 或远程 fetch - 不要
COPY . .再跑composer install——这等于把网络依赖又拖回离线环境
宿主机打包后挂载进容器:容易踩坑的替代路径
如果 CI 不支持多阶段构建,就得在宿主机生成 vendor/ 后挂载进容器,但必须对齐环境细节,否则类加载就崩。
- 宿主机和容器 PHP 版本必须一致(小版本号也要对得上),否则
autoload.php可能因扩展 ABI 变更失效 - 挂载前执行
chown -R 82:82 vendor/(假设容器内 www-data UID=82),否则 Linux 容器读不了 macOS/Windows 下生成的文件 - 必须在目标环境里运行
composer dump-autoload --classmap-authoritative --optimize,否则文件系统缓存或 PSR-4 路径扫描可能漏类 - 别只拷
~/.composer/cache/files/:ZIP 包没元数据绑定,离线时 Composer 根本不知道该用哪个
离线添加新包:不能用 require,只能走 path 仓库
composer require 默认强制联网解析依赖树,离线场景下它连本地缓存都不查,直接报错。
- 把目标包(含合法
composer.json)放到项目内,如./packages/my-utils - 项目
composer.json中加:{"type":"path","url":"./packages/my-utils"} - 执行
COMPOSER_DISABLE_NETWORK=1 composer require acme/utils:@dev(必须带@dev) - 立刻补一记
composer dump-autoload -o,否则autoload.php不包含该包路径
真正难的从来不是“怎么装”,而是“在哪装、装完怎么用”。PHP 版本、扩展 ABI、UID/GID、autoload 生成方式、lock 文件中 source 类型……任何一项对不齐,都会在运行时报 Class not found,而这个错误不会告诉你缺了哪一环。

















