如何使用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 global require composer/satis

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

初始化配置文件：

satis init

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

配置只镜像你需要的包

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

{ "name": "My Company Composer Repository", "homepage": "https://packages.mycompany.com", "repositories": [ { "type": "vcs", "url": "https://github.com/doctrine/orm" }, { "type": "vcs", "url": "https://github.com/guzzle/guzzle" }, { "type": "vcs", "url": "https://github.com/symfony/http-foundation" } ], "require-all": false, "require": { "doctrine/orm": "^2.10", "guzzlehttp/guzzle": "^7.4", "symfony/http-foundation": "^6.0" }, "output-dir": "web" }

关键点说明：

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

生成静态仓库

运行构建命令：

satis build satis.json .

Satis 会：

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

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

部署为内部代理服务

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

server { listen 80; server_name packages.mycompany.com; root /var/www/satis/web; index index.html; autoindex off; }

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

客户端使用你的 Satis 仓库

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

{ "repositories": [ { "type": "composer", "url": "https://packages.mycompany.com" } ] }

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

composer config -g repositories.company composer https://packages.mycompany.com

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

自动化更新

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

# crontab -e 0 3 * * * cd /path/to/satis && satis build satis.json . >> build.log 2>&1

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

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

# composer # php # html # js # git # json # github # nginx # 工具 # 配置文件 # symfony # require # 递归 # var # http # https # 自动化 # Foundation # 镜像 # 设为 # 内网 # 的是 # 客户端 # 你可以 # 你要 # 不需要 # 还能

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】