Private Packagist是Composer官方提供的私有包管理服务，支持与GitHub等平台集成，实现私有库的自动同步、权限控制和公共包镜像。通过创建组织、连接Git仓库、配置API认证，即可在项目中安全引入私有依赖，提升团队协作效率与部署稳定性。
如果你在开发 PHP 项目，并且使用 Composer 来管理依赖，那么你可能已经接触过 Packagist.org —— 官方的公共包仓库。但当你需要托管私有库、控制访问权限或统一管理企业内部的多个 Composer 包时，Private Packagist 就是一个非常实用的解决方案。
本文将介绍 Private Packagist 是什么，它的核心功能，以及如何一步步创建和使用一个私有的 Composer 服务。
什么是 Private Packagist？
Private Packagist 是由 Composer 官方团队（通过 packagist.com）提供的商业服务，允许你安全地托管和管理私有的 Composer 包。它与你的 Git 仓库（如 GitHub、GitLab、Bitbucket）集成，自动同步代码变更并生成可用的 Composer 可安装包。
它的主要优势包括：
- 支持私有和公有包的统一管理
- 细粒度的用户和团队权限控制
- 与主流 Git 托管平台无缝集成
- 支持镜像官方 packagist.org，提升下载速度
- 提供 Webhook 自动更新机制
- 企业级安全和审计日志
注册与创建组织
前往 https://www.php.cn/link/1fd1df658a0a3d7f385185db7c9c5029 注册账号。注册后，你可以创建一个“组织”（Organization），用于隔离不同团队或公司的包。
步骤如下：
- 登录后点击 “Create Organization”
- 输入组织名称（例如 your-company）
- 选择订阅计划（有免费试用版，支持少量私有包）
- 完成创建
创建完成后，你会进入该组织的仪表盘，可以开始添加仓库和包。
连接你的 Git 仓库
Private Packagist 支持连接 GitHub、GitLab、Bitbucket 等平台。你需要授权它访问你的代码仓库。
以 GitHub 为例：
- 在组织页面点击 “Add Repository”
- 选择 “GitHub” 作为来源
- 点击 “Connect to GitHub”，并授权 Private Packagist 访问你的 GitHub 账户
- 从列表中选择你要添加的私有仓库（比如 your-company/payment-sdk）
- 确认添加
添加成功后，Private Packagist 会自动扫描项目的 composer.json 文件，并将这个项目识别为一个可发布的 Composer 包。每次你推送新标签（tag），它都会自动同步发布。
在项目中使用私有包
现在你的私有包已经在 Private Packagist 上可用，接下来就是在其他项目中安装它。
首先，在你的项目根目录下的 composer.json 中配置仓库源：
"repositories": [
{
"type": "composer",
"url": "https://your-company.packagist.com/"
}
],
"require": {
"your-company/payment-sdk": "^1.0"
}
然后设置认证信息，让 Composer 能够登录下载私有包。有两种方式：
- 使用 API Token：在 Private Packagist 的用户设置中生成一个 API token
- 使用用户名密码：推荐使用 token 更安全
运行以下命令配置认证：
composer config http-basic.your-company.packagist.com YOUR_USERNAME YOUR_API_TOKEN
执行完成后，运行：
composer install
你的私有包就会被正常下载安装。
高级功能与最佳实践
Private Packagist 还提供一些增强功能，帮助你更好地管理生态：
- 镜像 packagist.org：可以在设置中开启“Mirror public packages”，这样所有公共包也通过你的私有域名下载，提升稳定性与速度
- 团队协作：可以添加成员并分配角色（管理员、开发者、只读等）
- Webhook 自动同步：每次提交 tag 都能自动触发更新，无需手动操作
- 私有包版本管理：支持 semantic versioning，与标准 Composer 流程一致
建议为每个内部组件建立独立仓库，并规范版本号和 composer.json 描述，便于复用和维护。
基本上就这些。Private Packagist 极大地简化了私有 PHP 包的分发流程，尤其适合中大型团队或需要合规审计的企业环境。虽然它是付费服务，但省去自建 Satis 或 Toran Proxy 的运维成本，长期来看反而更高效稳定。
