Composer 入门教程 Composer 使用别名

2024-02-25 开发教程 Composer 入门教程 匿名 5

别名

为什么使用别名?

当你使用 VCS 资源库,你将只会得到类似于这样的版本号:从分支发布的标签获取,它看起来像 2.02.0.x。比较特殊的是,对于你的 master分支,你会得到一个最新提交的 dev-master版本。对于你的 bugfix分支,你会得到一个最新提交的 dev-bugfix版本。以此类推,这些特殊的版本标识可以用来获取最新的分支源码。

如果你的 master分支使用标签发布了 1.0系列版本,即 1.0.11.0.21.0.3等等,任何依赖它的资源包都可能会使用 1.0.*这个版本约束。

如果有人想要最新的 dev-master版本,他们将会碰到一个问题:另一些依赖它的包可能使用了 1.0.*这个版本约束,因此在 require 这个开发版本时将会产生冲突,因为 dev-master不符合 1.0.*的约束。

这时,就可以使用别名。

分支别名

dev-master指向一个在你 VCS 项目上的主分支。有些用户会想要使用最新的开发版本,这是相当常见的情况。因此,Composer 允许你别名你的 dev-master版本为一个 1.0.x-dev的版本号。这是通过在 composer.json文件中的 extra下指定 branch-alias字段来完成的:

{
"extra": {
"branch-alias": {
"dev-master": "1.0.x-dev"
}
}
}

此处的分支版本必须以 dev-开头(不可比较的版本名称),对应的别名必须是可比较的开发版本名称(即,以数字开头,并以 .x-dev结束)。branch-alias所引用的分支必须是存在的。对于 dev-master你需要在 master分支上提交它。

其结果是,任何人都可以使用 1.0.*版本约束来得到 dev-master版本。

为了定义分支别名,你必须是需要别名的包的所有者。如果你想别名一个第三方包,而又不想 fork 它到自己的版本库,可以使用行内别名,我们在接下来就会提到它。

使用行内别名

分支别名是非常适合用于主开发分支的。但为了使用它们,你需要拥有对源码的控制权,并且你需要提交别名修改到你控制的版本库。

当你只想在本地项目中尝试一些依赖包的 bug 修正时,这并不是最好的方式。

出于这个原因,你可以在 requirerequire-dev字段中直接别名你需要的包。比方说那你找到了 monolog/monolog的一个 bug。你在 GitHub 上克隆了 Monolog 并在名为 bugfix的分支上修正了一个问题。现在你想安装这个版本到你的本地项目。

你所使用的 symfony/monolog-bundlerequire 了 monolog/monolog并约束了版本 1.*. 因此你需要让你的 dev-bugfix满足该版本约束。

只要在你项目根目录的 composer.json文件中加入以下内容:

{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/you/monolog"
}
],
"require": {
"symfony/monolog-bundle": "2.0",
"monolog/monolog": "dev-bugfix as 1.0.x-dev"
}
}

它将会在你的 GitHub 上获取 monolog/monologdev-bugfix版本并将其版本别名为 1.0.x-dev

注意: 如果要对一个资源包使用行内别名,这个别名(as的右边)必须能够使用版本约束。as左边的部分在这之后将被丢弃。因此,如果 A 依赖 B 而 B 又依赖 monolog/monolog且版本约束为 dev-bugfix as 1.0.x-dev,那么安装 A 时将使用 B 的版本约束,并识别为 1.0.x-dev,此时必须真实存在一个“分支别名”或“1.0 系列分支”。否则就必须在 A 的 composer.json文件中再次定义行内别名。

注意: 应该尽量避免行内别名,特别是对已经发布的包。如果你发现了一个 bug,请尝试将你的修复合并到上游分支。这将避免使用你资源包的用户出现问题。