如何使用 composer 管理私有仓库（Private Repository）？

配置私有仓库需在composer.json中添加repositories字段指定VCS或composer类型源，如Git地址或私有Packagist；通过HTTPS凭据或SSH密钥处理认证，推荐使用SSH；敏感信息应存于全局auth.json或CI/CD环境变量COMPOSER_AUTH；私有包需正确设置名称与版本标签，使用标签而非分支以确保依赖稳定。

配置私有仓库源

要在项目中使用私有仓库，需先在 composer.json 中声明仓库地址。支持的类型包括 VCS（Git）、Packagist 私有实例等。

常见做法是在 repositories 字段中添加 Git 仓库：

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://git.your-company.com/private-package.git"
        }
    ],
    "require": {
        "your-company/private-package": "^1.0"
    }
}

这样 Composer 就会从指定的 Git 地址拉取代码。注意：仓库必须公开可读，或配置认证信息。

处理身份认证

私有仓库通常需要登录凭证。Composer 提供多种方式管理认证：

• 使用 HTTPS + 用户名/令牌：将账号和访问令牌嵌入 URL 或由 Composer 配置存储
• 使用 SSH 密钥：推荐方式。配置好本地 SSH 公钥到 Git 服务器，Composer 自动使用默认密钥（如 ~/.ssh/id_rsa）

若用 HTTPS 并希望避免每次输入密码，可运行以下命令保存凭据：

标签： php js git json composer proxy 环境变量 asic