要实现Composer完全离线安装，核心是用Satis构建静态私有包仓库，生成含packages.json和ZIP包的本地目录，离线环境通过file://协议引用该目录即可完成依赖解析与安装。
要实现 Composer 完全离线安装，核心不是“镜像 Packagist”，而是用 Satis 搭建一个**静态的、可离线分发的私有包仓库**。它不实时同步 Packagist，而是按需抓取指定包的指定版本，生成静态 JSON 和 ZIP 文件，之后所有依赖解析和下载都走本地文件系统（如 file:// 协议），彻底脱离网络。
一、准备基础环境与目标包列表
Satis 本身是 PHP 命令行工具，需在有网环境运行一次来“快照”所需包。你需要明确：哪些包（含所有依赖）、哪些版本、是否需要 dev 分支（一般不建议离线包含 dev 版本）。
- 新建一个
packages.json列出主项目依赖（例如 Laravel + Guzzle + 自研私有包） - 确保这些包在 Packagist 或其他公开源（如 GitHub）可访问；私有包需配置 VCS 仓库并保证 Satis 能 clone
- 推荐使用
composer show --tree或composer depends辅助理清完整依赖树
二、用 Satis 构建静态仓库
在联网机器上执行：
windows-shell
下载
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
- 用 Composer 全局安装 Satis：
composer global require composer/satis - 编写
satis.json，关键字段包括：
–name和homepage（仅展示用）
–repositories：列出所有源（Packagist、GitHub、GitLab、私有 Git 等）
–require-all或require：精确声明要打包的vendor/name:version（支持^、~，但离线场景建议写死版本如"monolog/monolog": "2.9.1"）
–archive：启用 ZIP 打包（"format": "zip"），这是离线安装必需项 - 运行构建：
php ~/.composer/vendor/bin/satis build satis.json ./web（输出到./web目录） - 构建完成后，
./web下会有packages.json、各包 ZIP 及include/子文件，整个目录就是你的离线仓库
三、在离线环境中配置 Composer 使用本地仓库
无需运行任何服务，直接通过 file:// 协议引用本地目录：
- 把
./web整个目录拷贝到离线机器（如 U 盘、内网共享路径） - 在项目
composer.json中添加仓库：
"repositories": [
{
"type": "composer",
"url": "file:///path/to/your/web"
}
]
- 注意路径必须是绝对路径，Windows 用
file:///C:/path/to/web（三个斜杠） - 运行
composer install或composer update—— Composer 会读取本地packages.json，再从同一目录下拉 ZIP 包解压，全程无网络请求 - 可加
--no-interaction --prefer-dist确保跳过交互、强制用 ZIP 包
四、维护与注意事项
离线仓库不是“一次生成永久有效”，需按需更新：
- 新增包或升级版本？修改
satis.json后重新satis build，再同步新./web目录 - ZIP 包默认不包含
vendor/，只含源码（即composer install仍会在本地执行 autoload 生成等操作） - 若需跳过 autoload 生成（极端精简场景），可提前在构建机运行
composer dump-autoload --classmap-authoritative并打包进 ZIP，但非常规做法 - 私有包务必确保 Satis 构建时能访问其 Git 仓库（如配置 SSH key 或使用 HTTPS + token）；否则构建失败
基本上就这些。Satis 不是代理，而是“包快照生成器”。只要构建时网络通畅、包源可达，后续所有开发、CI、部署机器都不再需要外网——真正离线，也足够稳定。
