Composer离线部署的核心是提前固化全部远程资源，而非跳过网络；需在有网环境执行composer install --no-install --prefer-dist --no-scripts下载ZIP包及packages.json，再通过自定义本地repo和--no-network完成离线安装。
Composer 项目离线部署的核心，不是“跳过网络”，而是把
所依赖的全部远程资源——包源码、元数据、压缩包校验信息——提前固化下来，让目标环境完全不触网也能复现一致的
。
离线部署必须提前做：vendor 目录不能直接打包上传
直接 zip 当前
并传到另一台机器，大概率失败。原因包括：
中部分包含
脚本（如 Laravel 的
），离线环境缺少 PHP 扩展或命令会中断
不同系统（Linux/
mac
OS/Windows）下
行为不一致，
里的软链可能失效
某些包（如
依赖的
）在
阶段才编译，二进制不可跨平台迁移
记录的是 dist URL 和 sha256，但没存实际 zip 包 —— 离线时
仍会尝试 GET 这些 URL
正确做法：用
composer
install --no-install + composer archive 提取完整离线包
关键不是“缓存”，而是让 Composer 主动下载所有 dist zip 并保留本地副本。需分两步：
在有网环境执行：
这会让 Composer 仅解析
，下载所有包的 dist ZIP 到
，但不解压、不执行脚本
然后手动打包这些 ZIP：
注意：别漏掉
（位于
），它包含包名→zip路径映射，离线时必须存在
离线环境还原 vendor：用 composer install --no-network + 自定义 repo
目标机器无需联网，但需满足两个前提：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
已将上一步打包的
解压到统一目录（如
），结构保持
层级
修改项目根目录下的
，强制指向本地 repo：
最后运行：
是硬性开关，它会让 Composer 完全跳过 HTTP 请求；
确保走 zip 解压路径而非
git
clone
更稳妥的替代方案：使用 composer-paquet + build-phar
如果项目对可移植性要求极高（比如交付给客户内网服务器），推荐用社区工具
封装成单文件 PHAR：
安装：
生成离线包：
它会自动收集所有依赖、
映射、甚至
命令入口，最终输出一个可执行 PHAR
在目标机运行：
或直接
这个方案绕开了
目录结构问题，但要注意：PHAR 不支持动态加载未打包进来的类，所有依赖必须在构建时静态分析到。
composer installvendorvendorvendorpost-install-cmdphp artisan optimize:clearsymlinkvendor/binext-redisphpredisinstallcomposer.lockcomposer install --no-interactioncomposer install --no-install --prefer-dist --no-scriptscomposer.lockvendor/composer/cache/files/cd vendor/composer/cache/files && find . -name "*.zip" -print0 | tar -cz0f ~/my-project-offline-packages.tgz -T -packages.jsonvendor/composer/cache/repo/https---packagist.org/.tgz/opt/composer-offline-cachevendor/composer/cache/...composer.json{
"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--prefer-distcomposer-paquetcomposer global require "naderman/composer-paquet"composer-paquet build --output=offline.phar --no-devautoloadbinphp offline.phar installphp offline.phar your-script.phpvendor