断网时不能直接复制旧 vendor 目录,必须用完整 Composer 缓存(~/.composer/cache/files/)配合 composer.lock,在新服务器清缓存、校验 PHP 版本与扩展后执行 composer install。

断网时 vendor 目录不能直接复制
直接把旧服务器的 vendor/ 整个目录拷到新服务器,在断网且环境稍有差异(PHP 版本、扩展、OS 架构、路径长度)时,几乎必然失败。典型现象包括:Class not found(autoloader 里硬编码了旧绝对路径)、Failed to open stream: No such file or directory(vendor/bin 脚本第一行仍指向旧 PHP 解释器路径)、Package is not installed correctly(post-install-cmd 没执行,缺失生成文件或配置)。这些不是“运气不好”,而是 Composer 在安装阶段就做了平台敏感处理。
必须打包 ~/.composer/cache/files/ 而非只传 composer.lock
离线还原依赖的前提是:新服务器上 composer install 能从本地缓存读取 ZIP 包,而不是尝试联网下载。这意味着你得把旧服务器完整的 Composer 缓存文件夹打成包——不是只挑几个 ZIP,也不是只传 composer.lock。
-
~/.composer/cache/files/(Linux/macOS)或C:\Users\用户名\AppData\Roaming\Composer\Cache\files\(Windows)是唯一有效的缓存位置,其他路径(如vendor/或临时目录)不被composer install认可 - 必须确保旧服务器已执行过完整安装:
composer install --no-dev --prefer-dist,否则缓存里可能缺子依赖(transitive dependencies)的 ZIP - 新服务器上先清空原有缓存:
composer clear-cache,再把打包的files/解压覆盖过去,否则旧缓存可能干扰离线行为
新服务器运行 composer install 前要检查三件事
即使缓存齐备,composer install 仍可能静默失败或跳过关键步骤。以下检查项缺一不可:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 确认 PHP CLI 可用且版本匹配:
php -v输出需与composer.json中"config": {"platform": {"php": "8.1.10"}}完全一致;写成"8.1"或"^8.1"会被忽略 - 必需扩展必须已启用:
php -m | grep -E "openssl|mbstring|xml|zip|json",缺任一都可能导致安装中断且无明确报错 - 确保
composer.lock已存在且未被修改;若旧服务器没提交它,先在断网前运行composer update --lock固定哈希,再备份
别信“跳过校验”的临时方案
有人会建议加 --ignore-platform-reqs 或 --no-scripts 强行过掉检查,这在离线场景下尤其危险:
-
--ignore-platform-reqs会让 Composer 忽略 PHP 版本和扩展要求,结果装出无法运行的扩展(如ext-gd在没装 GD 库的系统里编译失败,但错误被吞掉) -
--no-scripts会跳过post-install-cmd,而很多包(如 Laravel 的php artisan package:discover)依赖它注册服务提供者,漏掉就直接Class not found - 真正安全的做法是:删掉新服务器上所有残留的
vendor/和composer.lock,重来一遍,不省任何一步
断网迁移最易被忽略的点,是以为“缓存 ZIP 有了就能跑通”。其实 composer install 在离线模式下依然要解析依赖树、校验哈希、生成 autoloader、执行脚本——每一步都依赖环境就绪。少一个扩展、错一个平台声明、缓存路径没对齐,都会让整个过程卡在无声失败里。










