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 不支持动态加载未打包进来的类，所有依赖必须在构建时静态分析到。
