如何使用Satis或Private Packagist搭建自己的composer私有仓库？-composer-PHP中文网

如何使用Satis或Private Packagist搭建自己的composer私有仓库？

裘德小鎮的故事

发布： 2025-11-01 15:51:02

原创

488人浏览过

Satis是免费开源的静态仓库生成器，适合自托管但需手动更新；Private Packagist是商业服务，支持自动同步和权限管理，适合团队协作。根据成本与运维需求选择方案即可。

如何使用satis或private packagist搭建自己的composer私有仓库？

搭建自己的 Composer 私有仓库，主要目的是在团队或企业内部安全地分发私有 PHP 包，避免将代码暴露在 Packagist.org 这类公共平台。Satis 和 Private Packagist 是两种主流方案，各有适用场景。

什么是 Satis？

Satis 是一个静态的 Composer 仓库生成器，由 Composer 官方团队维护。它从你指定的 VCS（如 Git）源拉取包信息，生成一个静态的 packages.json 文件，部署后可作为私有仓库使用。

优点：

完全免费、开源
自托管，数据可控
支持 Git、SVN、Mercurial 等多种源

缺点：

需要手动或定时重建仓库（可通过 CI/CD 自动化）
无用户权限管理功能，需配合 Web 服务器鉴权实现访问控制
界面简陋，仅提供基础列表页面

如何使用 Satis 搭建私有仓库？

以下是基本步骤：

1. 安装 Satis

composer create-project composer/satis --no-dev

登录后复制

2. 配置 satis.json

在项目根目录创建 satis.json 文件：

{
    "name": "My Private Repository",
    "homepage": "https://packages.example.com",
    "repositories": [
        { "type": "vcs", "url": "https://github.com/myorg/private-package" },
        { "type": "vcs", "url": "ssh://git@bitbucket.org/myteam/another-package.git" }
    ],
    "require-all": true
}

登录后复制

也可使用 "require" 字段精确指定版本：

"require": {
    "myorg/private-package": "^1.0"
}

登录后复制

3. 生成静态仓库

php bin/satis build satis.json public/

登录后复制

生成的文件会放在 public/ 目录下，包含 index.html 和 packages.json。

4. 部署到 Web 服务器

将 public/ 目录部署到 Nginx 或 Apache，确保可通过 HTTPS 访问，例如：https://packages.example.com/packages.json。

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

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

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

登录后复制

然后就可以正常 require 私有包了。

6. 自动化更新（推荐）

通过 GitHub Actions、GitLab CI 或 cron 脚本定期运行 satis build，确保新提交的包及时同步。

什么是 Private Packagist？

Private Packagist 是一个商业服务（也支持私有部署），提供完整的私有 Composer 仓库解决方案，集成 GitHub、GitLab、Bitbucket 等平台。

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

查看详情

优点：

自动同步 VCS 变更，无需手动构建
完善的用户和权限管理（支持团队、组织）
支持私有镜像公共包（加速下载）
提供 Web UI、Webhook、审计日志等功能
支持 SaaS 和本地部署（Enterprise 版）

缺点：

收费（但个人或小团队可用免费计划）
数据托管在第三方（除非使用自托管版）

如何使用 Private Packagist？

1. 注册并登录

访问 https://www.php.cn/link/1fd1df658a0a3d7f385185db7c9c5029，注册账号。

2. 创建组织

进入后台，创建组织，用于管理多个项目和成员。

3. 连接代码平台

绑定 GitHub、GitLab 或 Bitbucket 账号，授权 Private Packagist 读取私有仓库。

4. 添加私有包

在控制台点击“Add Package”，搜索你的私有仓库并添加。系统会自动分析 composer.json 并同步版本。

5. 配置认证

Private Packagist 提供 API Token，可在 composer.json 或全局配置中设置：

composer config http-basic.packagist.com username token

登录后复制

6. 在项目中使用

添加仓库源：

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://www.php.cn/link/1fd1df658a0a3d7f385185db7c9c5029"
        }
    ]
}

登录后复制

之后即可 require 你的私有包，就像使用公共包一样。