不能直接拷贝 vendor 目录,因 autoload 规则、minimum-stability、post-autoload-dump 脚本(含绝对路径)与原项目强绑定,易致 Class not found 或自动加载错乱;应复用 Composer 缓存并配合 --prefer-dist --no-scripts --no-plugins 等参数安装。

离线环境不能直接拷贝 vendor 目录
直接把外网项目下的 vendor 文件夹复制到离线服务器,大概率导致 Class not found、插件未加载或自动加载错乱。原因在于:autoload 规则、minimum-stability 设置、post-autoload-dump 脚本(含绝对路径)都和原项目强绑定。
真正可复用的是 Composer 缓存,不是 vendor 本身。缓存默认存在:
- Linux/macOS:
~/.composer/cache/files/ - Windows:
%APPDATA%\Composer\Cache\files\
只要目标机器架构一致(x86_64/arm64)、PHP 版本兼容、且缓存未被清空,就能跳过下载阶段。
复用缓存必须配对环境变量或 config
离线机上光有缓存文件还不够,Composer 必须知道去哪读。两种方式任选其一:
- 修改
~/.composer/config.json,确保cache-dir字段指向你传过去的缓存路径 - 或在执行前设环境变量:
export COMPOSER_CACHE_DIR=/path/to/your/cache
验证是否生效:运行 composer config --global cache-dir,输出应为你的自定义路径。若仍显示默认路径,说明配置没落进正确用户的家目录(比如用了 sudo 写入 /root/.composer/,但 PHP-FPM 以 www 用户运行)。
离线 install 必须加关键参数
即使缓存就位,不加参数仍可能失败。推荐命令组合:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
composer install --prefer-dist --no-scripts --no-plugins --no-dev --ignore-platform-reqs
各参数作用:
-
--prefer-dist:强制走缓存里的.zip/.tar.gz包,不尝试git clone -
--no-scripts:跳过post-autoload-dump等脚本,避免因路径/权限/扩展缺失报错 -
--no-plugins:禁用插件,防止插件自身依赖网络或本地服务 -
--no-dev和--ignore-platform-reqs:绕过开发包与 PHP 扩展版本校验
内网镜像服务是长期离线的替代方案
如果缓存不可靠(比如包被删、PHP 版本跨代),就得搭最小化镜像服务:
- 用
composer archive把每个依赖打包成.zip,放到内网 HTTP 服务下(如 Nginx 的/packages/) - 在项目
composer.json中添加仓库:{"type": "composer", "url": "http://192.168.10.10/packages/"} - 手动准备
packages.json(可用composer dump-autoload辅助生成结构)
注意两点:一是所有依赖必须锁定具体版本号(dev-master 不支持);二是离线机的 openssl.cafile 或 curl.cainfo 若为空,即使走内网地址也会卡在 SSL 验证——要么配好 CA 路径,要么临时加 export COMPOSER_DISABLE_TLS=1(仅限可信内网)。










