首先配置 Bitbucket 为 VCS 仓库，在 composer.json 中添加 type 为 vcs 的私有仓库 URL，然后通过 App Password 或 SSH 提供认证凭据，确保私有包包含 composer.json 并正确定义 name 和版本，最后运行 composer update 安装依赖。
要在 Composer 中使用私有的 Bitbucket 仓库，你需要让 Composer 能够安全地访问该仓库。由于私有仓库无法公开访问，Composer 必须通过身份验证来拉取代码。以下是具体实现方法。
配置 Bitbucket 作为 VCS 仓库
Composer 支持将 Git 仓库（包括 Bitbucket）作为自定义的 VCS（版本控制系统）源。你只需在项目的 composer.json 文件中声明仓库地址：
- 打开项目根目录下的 composer.json 文件
- 在 repositories 字段中添加你的私有 Bitbucket 仓库信息
示例配置：
{
"repositories": [
{
"type": "vcs",
"url": "https://bitbucket.org/your-username/your-private-repo.git"
}
],
"require": {
"your-vendor/your-package": "dev-main"
}
}
注意：URL 应为 HTTPS 格式，确保能被 Composer 识别为 Git 仓库。
提供身份验证凭据
访问私有仓库需要认证。Composer 提供几种方式处理凭据：
-
使用 App Password（推荐）：
Bitbucket 不允许使用账户密码直接进行 Git 操作。你需要创建一个 App Password。
登录 Bitbucket → 设置 → App passwords → 创建新密码（赋予“读取仓库”权限）。
然后运行命令让 Composer 存储凭据：composer config http-basic.bitbucket.org your-email@example.com your-app-password -
使用 SSH 密钥（适用于命令行环境）：
将 SSH 公钥添加到 Bitbucket 账户的 SSH 密钥设置中。
使用 SSH 地址替换 HTTPS URL："url": "git@bitbucket.org:your-username/your-private-repo.git"
并确保本地 SSH agent 正常运行。
确保包有正确的命名和结构
你的私有仓库必须符合 Composer 包的基本要求：
- 项目根目录包含 composer.json 文件
- 定义了正确的 name（如：your-vendor/your-package）
- 设置了版本号或使用分支别名（如 "dev-main" 对应主分支）
- 推送到 Bitbucket 的代码包含更新后的 composer.json
安装依赖并测试
完成上述配置后，运行以下命令测试是否能正常安装：
composer update
如果一切正常，Composer 会克隆私有仓库并安装指定包。若出现认证错误，请检查 App Password 权限或 SSH 配置。
基本上就这些。只要配置好仓库地址、凭据和包信息，Composer 就能顺利使用私有 Bitbucket 项目。关键是确保认证方式正确且稳定。
