要实现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 构建静态仓库

在联网机器上执行：

• 用 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、部署机器都不再需要外网——真正离线，也足够稳定。