Composer如何利用Satis或Private Packagist搭建私服

Satis是开源的静态仓库生成器，适合小型团队自建私有包服务；Private Packagist为商业化方案，支持自动同步与细粒度权限管理，适用于中大型企业。

在使用 Composer 管理 PHP 项目依赖时，有时需要托管私有包，比如公司内部的组件库。由于这些包不能公开发布到 Packagist.org，就需要搭建私有包仓库。Satis 和 Private Packagist 是两种常见方案，下面介绍它们如何帮助你搭建 Composer 私服。

什么是 Satis？

Satis 是一个静态的 Composer 仓库生成器，由 Composer 官方团队维护。它本质上是一个“轻量级的 Packagist”，可以从指定的 VCS（如 Git）源抓取私有包信息，然后生成一个可供 Composer 使用的 packages.json 文件。

核心特点：

• 开源免费，可自行部署
• 生成静态文件，适合搭配 Nginx/Apache 托管
• 支持 Git、SVN、Mercurial 等版本控制系统
• 可以包含私有和公开包的混合镜像

1. 全局安装 Satis：
   composer global require composer/satis
2. 创建 satis.json 配置文件，定义仓库和包：

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

3. 生成静态仓库：
   satis build satis.json public/
4. 将 public/ 目录通过 Web 服务器暴露（如 https://packages.example.com）
5. 在项目 composer.json 中添加仓库：

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

6. 正常执行 composer require company/private-lib 即可安装

Private Packagist 是什么？

Private Packagist 是一个商业化的私有包托管服务，也提供自托管版本（Enterprise）。它功能更全面，适合中大型团队或企业。

主要优势：

Project IDX

Google推出的一个实验性的AI辅助开发平台

113

查看详情

• 支持自动同步 GitHub、GitLab、Bitbucket 的私有仓库
• 提供细粒度权限控制（用户、组织、团队）
• 支持私有包依赖私有包的完整解析
• 提供 Web UI 管理包、查看构建日志
• 支持镜像 Packagist.org 公共包，实现统一出口

1. 注册账号并登录 packagist.com
2. 添加你的 Git 服务（GitHub/GitLab 等），授权访问私有仓库
3. 在界面上添加私有包，或设置自动发现规则
4. Private Packagist 会自动拉取代码并解析 composer.json
5. 在本地项目中配置仓库地址和认证信息：

"repositories": [
    {
        "type": "composer",
        "url": "https://your-domain.packagist.com/packages/"
    }
],
"config": {
    "http-basic": {
        "your-domain.packagist.com": {
            "username": "your-email@example.com",
            "password": "your-api-token"
        }
    }
}

6. 运行 composer install 即可下载私有包

如何选择：Satis vs Private Packagist

根据团队规模和需求选择合适的方案：

• 用 Satis 如果：预算有限、团队小、不需要复杂权限管理、能接受手动或定时构建仓库
• 用 Private Packagist 如果：需要自动化同步、多团队协作、权限隔离、高可用性、更好的用户体验

Private Packagist 虽然是付费服务，但节省了运维成本和开发时间，对于企业来说性价比更高。

安全与认证建议

无论使用哪种方式，都要注意安全性：

• 使用 SSH 或 HTTPS + 个人访问令牌（PAT）克隆私有仓库
• 在 CI/CD 环境中使用专用机器账户和最小权限令牌
• 避免将敏感凭证硬编码在 composer.json 中，可通过环境变量注入
• 定期轮换 API 密钥

基本上就这些。Satis 适合轻量自建，Private Packagist 提供更完整的私有包管理体验。根据实际场景选择即可。不复杂但容易忽略的是权限和自动化同步机制的设计。

以上就是Composer如何利用Satis或Private Packagist搭建私服的详细内容，更多请关注php中文网其它相关文章！