如何在离线环境中搭建一个完整的Composer镜像_使用Satis构建包含所有依赖包的私有仓库

使用Satis搭建私有Composer镜像仓库可解决离线环境依赖安装问题：1. 在可联网服务器部署Satis并配置satis.json；2. 通过build命令抓取指定包及其依赖，生成静态packages.json和zip分发文件；3. 将输出目录部署至内网Web服务；4. 离线项目配置该仓库地址后即可使用composer install从本地源获取依赖。

在离线环境中使用 Composer 安装 PHP 依赖会遇到网络不可达的问题，因为默认情况下 Composer 需要连接 packagist.org 获取包信息和下载资源。为了解决这个问题，可以使用 Satis 搭建一个私有的、静态的 Composer 镜像仓库，将所需的所有依赖包缓存到本地，供离线环境使用。

理解 Satis 的作用

Satis 是 Composer 官方提供的工具，用于生成静态的 Composer 仓库。它能抓取指定的 Composer 包（包括依赖项），并将它们的信息和 dist 文件（如 zip 压缩包）构建为一个可被其他项目使用的私有镜像源。与 Packagist 不同，Satis 生成的是静态文件集合，适合部署在内网或离线服务器上。

准备构建环境

需要一台可联网的构建服务器来运行 Satis，收集所有必要的包。这台机器应满足以下条件：

• 安装 PHP 7.4 或更高版本
• 安装 Composer
• 有足够的磁盘空间存储大量包（几十 GB 可能更稳妥）
• Web 服务器支持（如 Nginx/Apache）用于提供静态文件访问

安装并配置 Satis

通过 Composer 全局或本地安装 Satis：

进入 satis 目录后，创建配置文件 satis.json，定义你要镜像的包和输出设置：

关键配置说明：

• require-all: true — 镜像整个 Packagist 所有公开包（慎用，数据量极大）
• require-dependencies / require-dev-dependencies — 自动包含依赖项
• archive.directory — 指定 dist 包输出目录
• prefix-url — 外部访问 ZIP 包的 URL 前缀

若不需镜像全部包，可使用 require 字段明确列出所需包：

构建镜像仓库

运行以下命令生成静态仓库：

该命令会：

AI Humanize

使用AI改写工具，生成不可被AI检测的文本内容

154

查看详情

• 读取配置中的 require 列表及其所有依赖
• 从对应仓库下载元数据
• 将每个版本打包为 ZIP 存入 web/dist/
• 生成 packages.json 作为 Composer 可读的索引文件

构建时间取决于包的数量，首次可能耗时数小时。

部署私有仓库

将生成的 web/ 目录部署到内网 Web 服务器，例如通过 Nginx 提供服务：

确保可通过 HTTP 访问：
→ 主索引：http://packages.local/packages.json
→ 包文件：http://packages.local/dist/vendor-package-version.zip

在离线项目中使用私有镜像

在目标项目的 composer.json 中添加仓库配置：

执行安装：

Composer 将从你的私有源拉取 packages.json，并下载预先打包好的 ZIP 文件，无需外部网络。

维护与更新

当需要新增包或更新版本时，在构建机上修改 satis.json，重新运行 build 命令，并同步更新 web/ 目录到服务器。建议定期执行以同步安全更新。

基本上就这些。搭建完成后，即使完全断网，只要客户端能访问私有仓库地址，就能正常进行依赖管理。关键是前期要把所有需要的包和层级依赖都抓取完整。

以上就是如何在离线环境中搭建一个完整的Composer镜像_使用Satis构建包含所有依赖包的私有仓库的详细内容，更多请关注php中文网其它相关文章！