如何在composer.json中使用分支别名(branch-alias)_为开发分支定义稳定的版本号

在使用 Composer 管理 PHP 项目依赖时，有时你需要让其他项目依赖你正在开发中的分支（如 dev-main 或 dev-develop），但又希望它能匹配某些版本约束（例如 ^2.0）。这时就可以通过 branch-alias 来为开发分支定义一个“虚拟”的稳定版本号。

什么是 branch-alias？

branch-alias 是 composer.json 中的配置项，用于将某个开发分支映射到一个假想的版本号。这样即使你的代码还在开发中（比如还在 main 分支），也能被当作某个稳定版本来引用。

这在以下场景非常有用：

• 你想测试一个尚未发布正式版本的包
• 你在 CI/CD 中依赖开发分支，但要求版本约束匹配（如 ^2.0）
• 你希望别人用 "your/package": "^2.0" 安装时，能拉取你 main 分支的最新代码

如何配置 branch-alias

在你的包的 composer.json 文件中添加 extra 字段下的 branch-alias 配置：

{
    "name": "you/your-package",
    "version": "dev-main",
    "extra": {
        "branch-alias": {
            "dev-main": "2.0.x-dev"
        }
    }
}

登录后复制

上面这段配置的意思是：

标签： php js json composer ai