搭建私有Composer仓库可选Satis或Private Packagist：Satis为自建轻量方案，适合中小团队，通过配置satis.json生成静态页面并部署Web服务即可；Private Packagist为企业级托管方案，免运维，支持权限管理与自动同步，适合大型团队。
想在团队或企业内部统一管理 PHP 包，又不想把代码公开到 Packagist.org？搭建一个私有 Composer 仓库是最佳选择。Satis 和 Private Packagist 是两种主流方案，下面分别介绍如何快速搭建。
Satis：自建轻量级私有仓库
Satis 是官方推荐的静态包仓库生成工具，适合中小型团队，部署简单，依赖少。
1. 安装 Satis
通过 Composer 全局安装 Satis：
composer global require composer/satis
确保全局 Composer bin 目录在系统 PATH 中，以便直接运行 satis 命令。
2. 配置 satis.json
创建项目目录并编写配置文件：
{
"name": "My Private Package Repository",
"homepage": "https://www.php.cn/link/3fc6ae40bfc04ae4123761055e639bc2",
"repositories": [
{ "type": "vcs", "url": "https://github.com/your-company/package-a" },
{ "type": "vcs", "url": "https://gitlab.com/your-company/package-b" }
],
"require-all": true
}
- repositories 列出所有需要收录的私有 Git 仓库。
-
require-all 自动包含所有分支和标签（也可用
require指定具体版本）。
3. 生成静态页面
运行命令生成 build 文件：
satis build satis.json public/
这会在 public/ 目录下生成 index.html 和 packages.json 等文件。
4. 部署 Web 服务
将 public/ 目录交给 Nginx 或 Apache 托管，确保可通过 HTTPS 访问（如 https://www.php.cn/link/3fc6ae40bfc04ae4123761055e639bc2）。
5. 在项目中使用
在需要使用的项目 composer.json 中添加仓库：
"repositories": [
{
"type": "composer",
"url": "https://www.php.cn/link/3fc6ae40bfc04ae4123761055e639bc2"
}
],
"require": {
"your-company/package-a": "^1.0"
}
运行 composer install 即可从私有源拉取包。
建议结合 CI/CD 工具（如 GitHub Actions）自动重建 Satis 页面，当私有包更新时触发同步。
Private Packagist：企业级托管方案
如果你希望省去运维成本，Private Packagist 是功能完整的商业解决方案，支持权限控制、Webhook 自动同步、审计日志等。
1. 注册账号
访问 https://www.php.cn/link/1fd1df658a0a3d7f385185db7c9c5029 注册企业账号，提供私有 Git 服务（GitHub、GitLab、Bitbucket 等）集成。
2. 添加私有仓库
在控制台中添加你的私有包仓库 URL，Private Packagist 会自动读取 composer.json 并索引版本。
3. 配置认证
系统提供专用令牌（Token），在本地或服务器上设置 Composer 认证：
composer config --global http-basic.packagist.example.com your-token
4. 使用私有源
只要包名匹配，Composer 会自动从 Private Packagist 下载，无需额外声明仓库（若开启“自动发现”功能）。
适合大型团队或需要精细权限管理的场景，支持 SSO、组织结构同步、多区域镜像等功能。
安全与维护建议
无论使用哪种方式，注意以下几点：
- 私有仓库必须启用 HTTPS，防止凭证泄露
- 限制 Git 仓库访问权限，仅允许必要人员推送
- 定期备份 Satis 配置或 Private Packagist 账户信息
- 使用 SSH 或个人访问令牌（PAT）克隆私有包，避免密码硬编码
基本上就这些。Satis 适合自控环境的小团队，Private Packagist 更适合追求稳定与效率的企业。选哪个，看你的运维能力和预算。
