Composer 包注册表

发布 Composer 用户或组织的包。

要求

要使用 Composer 包注册表，您可以使用 Composer 来使用，并使用像 curl 这样的 HTTP 上传客户端来发布包。

发布包

要发布 Composer 包，请使用请求正文中的包内容执行 HTTP PUT 操作。包内容必须是包含 composer.json 文件的压缩 PHP 项目。

如果相同名称和版本的包已存在，则无法发布包。您必须先删除现有包。

PUT https://gitea.example.com/api/packages/{owner}/composer

参数	描述
owner	包的所有者。

如果 composer.json 文件不包含 version 属性，您必须将其作为查询参数提供。

PUT https://gitea.example.com/api/packages/{owner}/composer?version={x.y.z}

使用 HTTP 基本身份验证的示例请求

curl --user your_username:your_password_or_token \
     --upload-file path/to/project.zip \
     https://gitea.example.com/api/packages/testuser/composer

或将包版本指定为查询参数

curl --user your_username:your_password_or_token \
     --upload-file path/to/project.zip \
     https://gitea.example.com/api/packages/testuser/composer?version=1.0.3

如果您使用 2FA 或 OAuth，请使用 个人访问令牌 而不是密码。

服务器将使用以下 HTTP 状态代码进行响应。

HTTP 状态代码	含义
201 已创建	包已发布。
400 错误请求	包无效。
409 冲突	具有相同参数组合的包文件已存在。

配置包注册表

要注册包注册表，您需要将其添加到 Composer config.json 文件中（通常位于 <user-home-dir>/.composer/config.json 下）。

{
  "repositories": [{
      "type": "composer",
      "url": "https://gitea.example.com/api/packages/{owner}/composer"
   }
  ]
}

要使用凭据访问包注册表，您必须在 auth.json 文件中指定它们，如下所示

{
  "http-basic": {
    "gitea.example.com": {
      "username": "{username}",
      "password": "{password}"
    }
  }
}

参数	描述
owner	包的所有者。
username	您的 Gitea 用户名。
password	您的 Gitea 密码或个人访问令牌。

安装包

要从包注册表安装包，请执行以下命令

composer require {package_name}

可选地，您可以指定包版本

composer require {package_name}:{package_version}

参数	描述
package_name	包名称。
package_version	包版本。