首先注册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
• 在本地运行命令添加凭证：

composer config --global --auth http-basic.packagist.yourcompany.com username token

其中 username 是你的邮箱或用户名，token 是刚生成的 API Token。

3. 配置项目的 composer.json

确保你的私有包项目根目录下的 composer.json 文件包含正确的包名和类型声明。

{ "name": "your-company/your-private-package", "type": "library", "autoload": { "psr-4": { "YourCompany\Package\": "src/" } }, "require": {} }

注意： 包名必须与你在 Private Packagist 中允许的命名空间匹配（如 your-company/*）。

jm-jsjkxyjs02-zlm-405

使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。

下载

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.0

Push 完成后，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 就能下载并安装该包。

基本上就这些。只要配置一次全局认证和仓库源，团队成员都可以无缝使用所有授权的私有包。维护起来也方便，提交代码 + 打标签 = 自动发布。安全又高效。