Composer离线部署的核心是提前固化全部远程资源，而非跳过网络；需在有网环境执行composer install --no-install --prefer-dist --no-scripts下载ZIP包及packages.json，再通过自定义本地repo和--no-network完成离线安装。

Composer 项目离线部署的核心，不是“跳过网络”，而是把 composer install 所依赖的全部远程资源——包源码、元数据、压缩包校验信息——提前固化下来，让目标环境完全不触网也能复现一致的 vendor。

离线部署必须提前做：vendor 目录不能直接打包上传

直接 zip 当前 vendor 并传到另一台机器，大概率失败。原因包括：

• vendor 中部分包含 post-install-cmd 脚本（如 Laravel 的 php artisan optimize:clear），离线环境缺少 PHP 扩展或命令会中断
• 不同系统（Linux/macOS/Windows）下 symlink 行为不一致，vendor/bin 里的软链可能失效
• 某些包（如 ext-redis 依赖的 phpredis）在 install 阶段才编译，二进制不可跨平台迁移
• composer.lock 记录的是 dist URL 和 sha256，但没存实际 zip 包 —— 离线时 composer install --no-interaction 仍会尝试 GET 这些 URL

正确做法：用 composer install --no-install + composer archive 提取完整离线包

关键不是“缓存”，而是让 Composer 主动下载所有 dist zip 并保留本地副本。需分两步：

• 在有网环境执行：

  composer install --no-install --prefer-dist --no-scripts

  这会让 Composer 仅解析 composer.lock，下载所有包的 dist ZIP 到 vendor/composer/cache/files/，但不解压、不执行脚本
• 然后手动打包这些 ZIP：

  cd vendor/composer/cache/files && find . -name "*.zip" -print0 | tar -cz0f ~/my-project-offline-packages.tgz -T -

  注意：别漏掉 packages.json（位于 vendor/composer/cache/repo/https---packagist.org/），它包含包名→zip路径映射，离线时必须存在

离线环境还原 vendor：用 composer install --no-network + 自定义 repo

目标机器无需联网，但需满足两个前提：

• 已将上一步打包的 .tgz 解压到统一目录（如 /opt/composer-offline-cache），结构保持 vendor/composer/cache/... 层级
• 修改项目根目录下的 composer.json，强制指向本地 repo：

  {
      "repositories": [
          {
              "type": "composer",
              "url": "file:///opt/composer-offline-cache/repo/https---packagist.org"
          }
      ],
      "config": {
          "cache-dir": "/opt/composer-offline-cache"
      }
  }

• 最后运行：

  composer install --no-network --prefer-dist --no-scripts --no-plugins

  --no-network 是硬性开关，它会让 Composer 完全跳过 HTTP 请求；--prefer-dist 确保走 zip 解压路径而非 git clone

更稳妥的替代方案：使用 composer-paquet + build-phar

如果项目对可移植性要求极高（比如交付给客户内网服务器），推荐用社区工具 composer-paquet 封装成单文件 PHAR：

• 安装：

  composer global require "naderman/composer-paquet"

• 生成离线包：

  composer-paquet build --output=offline.phar --no-dev

  它会自动收集所有依赖、autoload 映射、甚至 bin 命令入口，最终输出一个可执行 PHAR
• 在目标机运行：

  php offline.phar install

  或直接

  php offline.phar your-script.php

这个方案绕开了 vendor 目录结构问题，但要注意：PHAR 不支持动态加载未打包进来的类，所有依赖必须在构建时静态分析到。