如何在composer中定义和使用自定义的代码仓库(repository)？

在Composer中配置自定义仓库可从非Packagist源拉取依赖，如私有Git或本地路径；通过repositories字段定义git或path类型仓库，并在require中声明包名；私有仓库需用SSH密钥或PAT认证，推荐使用auth.json存储凭证；安装时执行composer install或require命令，Composer按仓库顺序查找并下载包；注意包需含合法composer.json且遵循PSR-4规范。

在 Composer 中定义和使用自定义代码仓库，是为了让 Composer 能够从默认的 Packagist 以外的地方拉取依赖包。比如你有私有 Git 仓库中的 PHP 包，或者使用了第三方托管平台（如 GitLab、Bitbucket），就需要手动配置 repository。

1. 定义自定义仓库

在项目的 composer.json 文件中，通过 repositories 字段添加自定义仓库。支持多种类型，常见的是 git 类型。

示例：添加一个 Git 仓库

{
    "repositories": [
        {
            "type": "git",
            "url": "https://github.com/username/my-private-package.git"
        }
    ],
    "require": {
        "username/my-private-package": "dev-main"
    }
}

也可以指定本地路径（适用于开发测试）：

{
    "repositories": [
        {
            "type": "path",
            "url": "../my-local-package/"
        }
    ],
    "require": {
        "username/my-local-package": "*"
    }
}

2. 使用私有 Git 仓库（如 GitHub、GitLab）

如果你的仓库是私有的，Composer 需要认证才能访问。可以通过以下方式处理：

• 使用 SSH 密钥（推荐）：确保你的部署环境已配置 SSH 公钥（如 GitHub 添加 deploy key）
• 使用 HTTPS + Personal Access Token（PAT）

例如使用 GitHub 的 token：

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/username/private-package"
        }
    ]
}

然后运行命令时，Composer 会提示输入用户名和密码，用户名任意，密码使用生成的 PAT。

也可以在 auth.json 文件中预先配置（避免明文写在 composer.json）：

{
    "http-basic": {
        "github.com": {
            "username": "your-username",
            "password": "your-personal-access-token"
        }
    }
}

该文件放在项目根目录或 Composer home 目录（如 ~/.config/composer/auth.json）。

3. 引入包并安装

一旦仓库配置完成，就可以在 require 中引用对应的包名（格式为 vendor/name），然后执行：

composer require username/my-private-package

或直接运行：

composer install

Composer 会优先检查你定义的仓库来查找所需包。

4. 注意事项

• repository 只告诉 Composer 去哪里找包，不自动引入。必须在 require 或 require-dev 中明确声明依赖
• 建议私有包也遵循 PSR-4 自动加载规范，并在 composer.json 中配置 autoload
• 如果多个仓库包含同名包，Composer 按 repositories 列表顺序查找，第一个命中即停止
• 使用 path 类型时，目标目录也必须有合法的 composer.json

基本上就这些。配置好仓库后，Composer 就能像使用 Packagist 包一样使用你的自定义包了。