搭建私有Composer仓库可用Satis实现，它通过读取配置文件生成静态JSON供Composer使用。1. 全局安装Satis：composer global require composer/satis，确保bin目录在PATH中。2. 创建satis.json配置文件，指定仓库名称、主页URL、代码仓库地址及输出目录，支持require-all或require精确控制包版本。3. 运行satis build satis.json .生成index.html和packages.json到output-dir。4. 将输出目录部署至Web服务器（如Nginx），确保域名可访问且能正确返回JSON。5. 在项目composer.json中添加私有仓库URL类型为composer，并在require中声明依赖。6. 配置crontab或CI/CD自动重建Satis仓库以同步最新版本。注意权限管理与凭证配置，适合中小型团队稳定使用。
搭建私有 Composer 仓库可以通过 Satis 实现，它是一个轻量级的静态包管理器，适合团队或企业内部发布私有 PHP 包。Satis 会读取你指定的 composer 包信息，生成一个可被 Composer 使用的静态 JSON 文件，并提供一个简单的 Web 界面展示这些包。
1. 安装 Satis
Satis 是一个基于 Composer 的工具，你可以通过 Composer 全局安装它：
composer global require composer/satis
确保你的系统已将 Composer 的全局 bin 目录加入 PATH，通常路径是 ~/.composer/vendor/bin，以便可以直接运行 satis 命令。
2. 配置 satis.json
在项目目录下创建一个 satis.json 配置文件，这是 Satis 的核心配置。以下是一个基础示例：
{
"name": "My Private Package Repository",
"homepage": "https://packages.example.com",
"repositories": [
{
"type": "vcs",
"url": "https://github.com/your-company/your-private-package"
}
// 可添加多个私有或公共仓库
],
"require-all": true,
"output-dir": "web"
}说明：
- name：仓库名称
- homepage：对外访问的 URL
- repositories：列出你要包含的 Git 仓库（支持 SSH、HTTPS）
- require-all：自动包含所有分支和标签（按 semver 规则）
- output-dir：生成的静态文件存放目录
如果你只想引入特定版本，可以使用 "require" 字段代替 "require-all"：
"require": {
"your-company/your-private-package": "dev-main"
}3. 生成静态仓库
运行以下命令生成静态包列表：
satis build satis.json .
该命令会拉取配置中所有仓库的元数据，并生成 index.html 和 packages.json 到输出目录（如 web/）。packages.json 就是 Composer 客户端要读取的包索引。
4. 部署 Web 服务
将输出目录部署到 Web 服务器。例如使用 Nginx：
server {
listen 80;
server_name packages.example.com;
root /path/to/web;
index index.html;
location / {
try_files $uri $uri/ =404;
}}
确保 Web 服务能正确返回 JSON 文件，且域名可访问。
5. 在项目中使用私有仓库
在你的 PHP 项目的 composer.json 中添加仓库配置：
{
"repositories": [
{
"type": "composer",
"url": "https://packages.example.com"
}
],
"require": {
"your-company/your-private-package": "^1.0"
}
}执行 composer install 时，Composer 会优先从你的私有仓库查找包。
如果使用的是私有 Git 仓库，还需确保运行 Composer 的机器已配置好 SSH 密钥或 HTTPS 凭据。
6. 自动更新仓库
建议设置定时任务（crontab）定期重建 Satis 仓库，以同步最新代码：
0 * * * * /home/user/.composer/vendor/bin/satis build /path/to/satis.json /path/to/web
也可结合 CI/CD 流程，在推送新版本后自动触发构建。
基本上就这些。Satis 虽然简单，但足够稳定，适合中小型团队搭建私有 PHP 包管理方案。不复杂但容易忽略权限和自动更新机制。
