将私有包发布到Satis或Toran Proxy需配置Composer使用私有仓库并确保包被正确索引。首先，私有包应为标准Composer包，包含composer.json文件，并推送到可访问的Git服务器；接着，在Satis中通过satis.json配置VCS仓库地址并构建静态索引，或将包手动添加至Toran Proxy；然后在项目composer.json中添加对应仓库URL；最后确保Satis/Toran服务器具备SSH密钥以拉取私有仓库。核心是Git权限与网络可达性。

将私有包发布到 Satis 或 Toran Proxy 的核心在于配置 Composer 使用私有的包仓库，并确保私有包能被正确索引和拉取。Satis 和 Toran Proxy 都是用于搭建私有 PHP 包管理服务的工具，其中 Satis 是静态构建的包列表，Toran Proxy 则兼具缓存公共包和代理私有包的功能。下面介绍如何将私有包发布并让项目通过它们安装。

准备私有包

你的私有包必须是一个标准的 Composer 包，包含 composer.json 文件，并推送到可访问的 Git 服务器（如 GitHub、GitLab、自建 Git 服务等）。

确保 composer.json 中包含正确的信息：

• name：格式为 vendor/package-name（如 mycompany/my-private-package）
• type：通常为 library
• autoload：配置好自动加载规则
• version 可省略，由 Git tag 决定

然后推送到私有 Git 仓库，例如：git@your-git-server.com:mycompany/my-private-package.git

配置 Satis 索引私有包

Satis 是一个静态的包生成器，它会抓取指定的包并生成一个 composer 可读的 JSON 文件。

编辑 Satis 的配置文件 satis.json：

{
  "name": "My Private Package Repository",
  "homepage": "https://satis.yourcompany.com",
  "repositories": [
    {
      "type": "vcs",
      "url": "git@your-git-server.com:mycompany/my-private-package.git"
    }
  ],
  "require-all": true
}

运行构建命令生成静态页面：

部署 web/ 目录到 Web 服务器后，你的私有包就会被收录在私有仓库中。

在项目中使用 Satis 仓库

在需要使用私有包的项目中，修改 composer.json，添加仓库源：

"repositories": [
  {
    "type": "composer",
    "url": "https://satis.yourcompany.com"
  }
]

然后正常 require 私有包：

Composer 会从你的 Satis 服务中查找并安装该包。

Toran Proxy 的配置方式

Toran Proxy 的配置类似，但可通过 Web 界面或配置文件手动添加包。

在 Toran 的后台中：

• 进入 "Add Package" 页面
• 输入私有包的 Git 地址（如 git@your-git-server.com:mycompany/my-private-package.git）
• 保存后 Toran 会抓取版本并索引

或者直接编辑 Toran 的配置文件（通常为 app/config/toran.yml），在 repositories 下添加 VCS 条目。

项目中配置仓库时使用 Toran 提供的 URL：

"repositories": [
  {
    "type": "composer",
    "url": "https://toran.yourcompany.com/private/packages.json"
  }
]

之后执行 composer update 即可安装私有包。

权限与 SSH 访问

由于私有 Git 仓库通常需要身份验证，确保运行 Satis 或 Toran 的服务器已配置 SSH 公钥，能无密码克隆私有仓库。

测试方式：

若无法拉取，请检查 SSH 密钥是否绑定到对应用户账号。

基本上就这些。只要私有包能被 Satis 或 Toran 访问并索引，再通过项目配置仓库地址，就能像使用 Packagist 一样安装私有包。关键是确保 Git 权限和网络可达。不复杂但容易忽略权限问题。