使用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：
composer create-project composer/satis --stability=stable --no-interaction进入 satis 目录后，创建配置文件 satis.json，定义你要镜像的包和输出设置：
{ "name": "My Private Composer Mirror", "homepage": "https://packages.example.com", "repositories": [ { "type": "vcs", "url": "https://github.com/your-company/priv-repo1" }, { "type": "composer", "url": "https://packagist.org" } ], "require-all": true, "require-dependencies": true, "require-dev-dependencies": true, "archive": { "directory": "dist", "format": "zip", "prefix-url": "https://packages.example.com", "skip-dev": false }, "config": { "secure-http": true } }关键配置说明：
- require-all: true — 镜像整个 Packagist 所有公开包（慎用，数据量极大）
- require-dependencies / require-dev-dependencies — 自动包含依赖项
- archive.directory — 指定 dist 包输出目录
- prefix-url — 外部访问 ZIP 包的 URL 前缀
若不需镜像全部包，可使用 require 字段明确列出所需包：
"require": { "laravel/framework": "^9.0", "symfony/http-foundation": "^6.0" }构建镜像仓库
运行以下命令生成静态仓库：
php bin/satis build satis.json web/该命令会：
- 读取配置中的 require 列表及其所有依赖
- 从对应仓库下载元数据
- 将每个版本打包为 ZIP 存入 web/dist/
- 生成 packages.json 作为 Composer 可读的索引文件
构建时间取决于包的数量，首次可能耗时数小时。
部署私有仓库
将生成的 web/ 目录部署到内网 Web 服务器，例如通过 Nginx 提供服务：
server { listen 80; server_name packages.local; root /var/www/satis/web; index index.html; autoindex off; }确保可通过 HTTP 访问：
→ 主索引：http://packages.local/packages.json
→ 包文件：http://packages.local/dist/vendor-package-version.zip
在离线项目中使用私有镜像
在目标项目的 composer.json 中添加仓库配置：
{ "repositories": [ { "type": "composer", "url": "http://packages.local" } ], "require": { "monolog/monolog": "^2.0" } }执行安装：
composer install --prefer-dist --no-scriptsComposer 将从你的私有源拉取 packages.json，并下载预先打包好的 ZIP 文件，无需外部网络。
维护与更新
当需要新增包或更新版本时，在构建机上修改 satis.json，重新运行 build 命令，并同步更新 web/ 目录到服务器。建议定期执行以同步安全更新。
基本上就这些。搭建完成后，即使完全断网，只要客户端能访问私有仓库地址，就能正常进行依赖管理。关键是前期要把所有需要的包和层级依赖都抓取完整。
