版本别名是Composer中将开发分支映射到虚拟版本的功能,通过在composer.json的extra.branch-alias中配置,如"dev-main": "1.0.x-dev",使其他包可用^1.0依赖该分支最新代码,便于主干开发、协同测试与避免频繁打tag。

在 Composer 中,版本别名(alias)主要用于将某个开发分支(如 dev-main)映射到一个特定的版本号,以便其他包可以依赖它,就像依赖一个正式发布版本一样。这在开发过程中特别有用,尤其是当你想让其他项目依赖你的主干开发版本但又受限于版本约束时。
什么是版本别名?
Composer 的版本别名让你可以把一个分支(比如 dev-main)“伪装”成某个语义化版本(如 1.0.x-dev)。这样,即使你还没有打 tag,其他包也能通过版本约束来使用这个分支。
例如:你想让 dev-main 被当作 1.0.x-dev 来处理,这样依赖它的包就可以写:"your/package": "^1.0"
而实际上安装的是 main 分支的最新代码。
如何设置别名?
在你要设置别名的包的 composer.json 文件中,使用 extra 字段下的 branch-alias 配置。
假设你的项目主分支是 main,你想让它被当作 1.0.x-dev 版本来使用:
{
"extra": {
"branch-alias": {
"dev-main": "1.0.x-dev"
}
}
}
这意味着:
- 当别人 require
^1.0时,Composer 可以选择1.0.x-dev这个“虚拟版本”。 - 而这个“虚拟版本”实际指向的是你的
dev-main分支。
常见用途和注意事项
版本别名常用于以下场景:
- 主干开发期间支持向后兼容的特性开发。
- 多个项目协同开发,避免频繁打 tag。
- 测试尚未发布的功能。
注意点:
- 别名只影响开发分支(
dev-前缀),不能用于 tag。 - 必须在被依赖的包中定义,而不是在使用它的项目里。
- 别名格式应遵循
X.Y.x-dev模式,X 和 Y 应与你计划发布的正式版本一致。 - 如果你的分支是
dev-develop,那应该写:"dev-develop": "1.1.x-dev"
实际效果示例
假设你有一个库 acme/utils,其 composer.json 设置了:
"extra": {
"branch-alias": {
"dev-main": "2.0.x-dev"
}
}
另一个项目依赖它:
{
"require": {
"acme/utils": "^2.0"
}
}
Composer 会解析 ^2.0 匹配到 2.0.x-dev,然后安装 acme/utils 的 main 分支最新代码。
基本上就这些。合理使用 branch-alias 能让开发流程更顺畅,尤其是在维护长期开发分支时。










