版本别名是将开发分支映射到虚拟语义化版本的功能,通过在composer.json的extra.branch-alias中配置,如将dev-main设为1.2.x-dev,使其他包可依赖该虚拟版本并使用对应分支代码。

在 Composer 中,你不能直接为同一个包的不同版本设置“别名”,但可以通过 版本别名(version alias) 的方式,将某个开发分支(如 dev 分支)映射到一个特定的版本号,从而让其他包可以依赖这个“虚拟版本”。
什么是版本别名?
版本别名允许你将一个开发分支(例如 dev-main)标记为某个语义化版本(如 1.2.3),即使该版本尚未正式发布。这在开发中特别有用,比如你想让另一个包依赖 my/package:1.2.3,而这个版本还在 main 分支上开发。
如何设置版本别名?
在你要设置别名的包的 composer.json 文件中,使用 extra.branch-alias 字段:
{
"name": "vendor/my-package",
"extra": {
"branch-alias": {
"dev-main": "1.2.x-dev",
"dev-develop": "2.0.x-dev"
}
}
}上面的配置表示:
-
dev-main分支被视为1.2.x-dev版本 -
dev-develop分支被视为2.0.x-dev版本
这样,其他包就可以这样依赖:
{
"require": {
"vendor/my-package": "1.2.x-dev"
}
}Composer 会自动使用 main 分支的代码来满足这个依赖。
自定义设置的程度更高可以满足大部分中小型企业的建站需求,同时修正了上一版中发现的BUG,优化了核心的代码占用的服务器资源更少,执行速度比上一版更快 主要的特色功能如下: 1)特色的菜单设置功能,菜单设置分为顶部菜单和底部菜单,每一项都可以进行更名、选择是否隐 藏,排序等。 2)增加企业基本信息设置功能,输入的企业信息可以在网页底部的醒目位置看到。 3)增加了在线编辑功能,输入产品信息,企业介绍等栏
使用场景说明
假设你正在开发一个库,主分支是 main,你希望提前测试它作为 1.2.0 的兼容性,但还没打 tag。通过设置别名:
- 避免频繁更新依赖中的分支名称
- 支持版本约束匹配(如 ~1.2.0)
- 便于 CI/CD 或内部项目提前集成未发布版本
注意事项
版本别名只对 -dev 分支有效(如 dev-main),不会影响已发布的版本(如 v1.2.3)。
别名不会创建新版本,只是改变了 Composer 对分支的版本解析方式。
确保别名格式符合语义化版本,并以 .x-dev 结尾(如 1.2.x-dev),否则可能无法正确匹配。
基本上就这些。合理使用 branch-alias 能让你的开发流程更灵活。









