如何使用Satis只镜像你需要的Composer包_构建一个轻量级的公司内部Composer代理

Satis是Composer官方推荐的轻量级私有仓库生成工具，通过配置satis.json指定需镜像的包（如doctrine/orm、guzzlehttp/guzzle等），结合require-all设为false实现精准控制，避免全量同步；利用satis build命令生成包含packages.json和dist文件的静态仓库，部署至内网Web服务器后，客户端通过添加仓库URL或全局配置优先使用内部源，提升安装速度并减少外部依赖，适合企业级PHP依赖管理。

在公司内部搭建一个轻量级的 Composer 代理，既能提升依赖安装速度，又能避免对 packagist.org 的频繁请求，还能精确控制哪些包可以被使用。Satis 正是为此设计的工具——它是一个静态的 Composer 仓库生成器，能让你只镜像需要的包，而不是整个 Packagist。

什么是 Satis？

Satis 是 Composer 官方推荐的一个工具，用于构建私有的、精简的 Composer 镜像仓库。它不像完全镜像那样同步所有包，而是根据你配置的规则，只抓取指定的包及其版本，生成一个 packages.json 文件供 Composer 使用。

这意味着你可以：

• 只允许团队使用经过审核的开源包
• 缓存常用包以加快 CI/CD 和本地安装速度
• 减少对外部网络的依赖
• 托管私有包（配合 artifact 或 VCS）

安装与初始化 Satis

通过 Composer 全局或项目方式安装 Satis：

确保 ~/.composer/vendor/bin 在你的 PATH 中，以便使用 satis 命令。

初始化配置文件：

这会生成一个默认的 satis.json 文件。

配置只镜像你需要的包

编辑 satis.json，明确列出你需要的包。例如：

关键点说明：

• repositories：声明源，支持 VCS、artifact、composer 等类型
• require：精确控制你要镜像的包和版本约束
• require-all：设为 false 表示只处理 require 中列出的包，不递归抓取全部依赖
• output-dir：生成的静态文件目录，通常设为 web 可访问路径

生成静态仓库

运行构建命令：

Satis 会：

猫眼课题宝

5分钟定创新选题，3步生成高质量标书！

262

查看详情

• 克隆或下载你指定的包
• 分析其 composer.json
• 提取元数据并写入 web/packages.json
• 将实际的 dist 文件（zip/tar）复制到 web/dist/ 目录

完成后，web/ 目录就是一个完整的静态 Composer 仓库。

部署为内部代理服务

将 web/ 目录部署到公司内网 Web 服务器，比如 Nginx：

确保 PHP 不需要执行，这只是静态文件服务。

客户端使用你的 Satis 仓库

在项目 composer.json 中添加仓库：

或者全局设置（推荐给所有员工）：

这样 Composer 会优先从你的 Satis 源查找包，未命中时才会回退到 packagist.org（除非你设置 "packagist.org": false 来禁用）。

自动化更新

建议通过 CI/CD 或定时任务定期重建仓库：

也可以结合 webhook，在你关注的包有新版本时触发重建。

基本上就这些。Satis 虽然功能简单，但非常适合构建轻量、可控的内部 Composer 代理。不复杂但容易忽略的是：一定要关掉 require-all，否则可能意外拉取成千上万个包，失去“轻量”的意义。

以上就是如何使用Satis只镜像你需要的Composer包_构建一个轻量级的公司内部Composer代理的详细内容，更多请关注php中文网其它相关文章！