首先注册Private Packagist账户并创建组织，获取私有仓库URL；接着配置API Token或SSH密钥完成认证；然后确保composer.json中包名符合命名空间规则；再将Git仓库关联到Private Packagist；通过打Git标签发布版本；最后在项目中添加仓库源并require包即可使用。
将私有包发布到 Private Packagist 可以让团队安全地托管和管理专有的 PHP Composer 包。整个过程并不复杂，关键在于配置好认证、仓库地址以及正确的 composer.json 文件。以下是详细操作指南。
1. 注册并创建 Private Packagist 账户
访问 https://www.php.cn/link/1fd1df658a0a3d7f385185db7c9c5029 并注册企业账户。完成邮箱验证后，创建组织（Organization），用于管理团队和私有包。
登录后，在仪表盘中你会看到专属的私有仓库地址，格式通常为：
https://packagist.yourcompany.com记下这个 URL，后续会用到。
2. 添加 SSH 公钥或 API Token 进行身份认证
Private Packagist 支持多种认证方式，推荐使用 API Token 或 SSH 密钥来确保自动化流程顺畅。
- 进入用户设置页面，生成一个 API Token
- 在本地运行命令添加凭证：
其中 username 是你的邮箱或用户名，token 是刚生成的 API Token。
3. 配置项目的 composer.json
确保你的私有包项目根目录下的 composer.json 文件包含正确的包名和类型声明。
注意： 包名必须与你在 Private Packagist 中允许的命名空间匹配（如 your-company/*）。
4. 将 Git 仓库关联到 Private Packagist
登录 Private Packagist 后台，点击 “Add Package”，选择从 GitHub、GitLab 或 Bitbucket 导入。
- 连接你的代码托管平台账号
- 选择要同步的私有仓库
- 保存后，Private Packagist 会自动监听该仓库的推送事件
你也可以手动触发同步，或设置 Webhook 实现自动更新。
5. 发布新版本
Private Packagist 通过 Git 标签识别版本。要发布一个新版本，只需打上符合 SemVer 规范的标签：
git tag -a v1.0.0 -m "Release version 1.0.0" git push origin v1.0.0Push 完成后，Private Packagist 会在几分钟内检测到新标签，并构建可用的 Composer 包。
6. 在项目中使用私有包
在需要引入私有包的项目中，先配置仓库源：
composer config repositories.packagist-com composer https://packagist.yourcompany.com然后正常 require 私有包：
composer require your-company/your-private-package:^1.0只要认证通过，Composer 就能下载并安装该包。
基本上就这些。只要配置一次全局认证和仓库源，团队成员都可以无缝使用所有授权的私有包。维护起来也方便，提交代码 + 打标签 = 自动发布。安全又高效。
