如何搭建自己的私有composer仓库Satis

发布时间：2025-10-07 | 点击率：

搭建私有Composer仓库可用Satis实现，它通过读取配置文件生成静态JSON供Composer使用。1. 全局安装Satis：composer global require composer/satis，确保bin目录在PATH中。2. 创建satis.json配置文件，指定仓库名称、主页URL、代码仓库地址及输出目录，支持require-all或require精确控制包版本。3. 运行satis build satis.json .生成index.html和packages.json到output-dir。4. 将输出目录部署至Web服务器（如Nginx），确保域名可访问且能正确返回JSON。5. 在项目composer.json中添加私有仓库URL类型为composer，并在require中声明依赖。6. 配置crontab或CI/CD自动重建Satis仓库以同步最新版本。注意权限管理与凭证配置，适合中小型团队稳定使用。

搭建私有 Composer 仓库可以通过 Satis 实现，它是一个轻量级的静态包管理器，适合团队或企业内部发布私有 PHP 包。Satis 会读取你指定的 composer 包信息，生成一个可被 Composer 使用的静态 JSON 文件，并提供一个简单的 Web 界面展示这些包。

1. 安装 Satis

Satis 是一个基于 Composer 的工具，你可以通过 Composer 全局安装它：

composer global require composer/satis

确保你的系统已将 Composer 的全局 bin 目录加入 PATH，通常路径是 ~/.composer/vendor/bin，以便可以直接运行 satis 命令。

2. 配置 satis.json

在项目目录下创建一个 satis.json 配置文件，这是 Satis 的核心配置。以下是一个基础示例：

{
    "name": "My Private Package Repository",
    "homepage": "https://packages.example.com",
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/your-company/your-private-package"
        }
        // 可添加多个私有或公共仓库
    ],
    "require-all": true,
    "output-dir": "web"
}

说明：

name：仓库名称
homepage：对外访问的 URL
repositories：列出你要包含的 Git 仓库（支持 SSH、HTTPS）
require-all：自动包含所有分支和标签（按 semver 规则）
output-dir：生成的静态文件存放目录

如果你只想引入特定版本，可以使用 "require" 字段代替 "require-all"：

"require": {
    "your-company/your-private-package": "dev-main"
}

3. 生成静态仓库

运行以下命令生成静态包列表：

satis build satis.json .

该命令会拉取配置中所有仓库的元数据，并生成 index.html 和 packages.json 到输出目录（如 web/）。packages.json 就是 Composer 客户端要读取的包索引。

4. 部署 Web 服务

将输出目录部署到 Web 服务器。例如使用 Nginx：

server { listen 80; server_name packages.example.com; root /path/to/web; index index.html;

location / {
    try_files $uri $uri/ =404;
}

}

确保 Web 服务能正确返回 JSON 文件，且域名可访问。

5. 在项目中使用私有仓库

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

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packages.example.com"
        }
    ],
    "require": {
        "your-company/your-private-package": "^1.0"
    }
}

执行 composer install 时，Composer 会优先从你的私有仓库查找包。

如果使用的是私有 Git 仓库，还需确保运行 Composer 的机器已配置好 SSH 密钥或 HTTPS 凭据。

6. 自动更新仓库

建议设置定时任务（crontab）定期重建 Satis 仓库，以同步最新代码：

0 * * * * /home/user/.composer/vendor/bin/satis build /path/to/satis.json /path/to/web

也可结合 CI/CD 流程，在推送新版本后自动触发构建。

基本上就这些。Satis 虽然简单，但足够稳定，适合中小型团队搭建私有 PHP 包管理方案。不复杂但容易忽略权限和自动更新机制。

上一篇：JAX中实现类似PyTorch scatter_add的全局
下一篇：JavaScript继承学习笔记【新手必看】