Composer 版本号

我们在开发过程中使用到许多第三方库,需要在composer.json中指明依赖库版本规则来安装恰当的包。

Composer 推荐的版本规则是语义化版本,版本格式:主版本号.次版本号.修订号,版本号递增规则如下:

  • 主版本号:当你做了不兼容的 API 修改
  • 次版本号:当你做了向下兼容的功能性新增
  • 修订号:当你做了向下兼容的问题修正

基本约束

具体版本

安装指明的具体版本,如果其他依赖包需要不同的版本,安装或更新过程将失败。

  • 1.2.3

范围

使用比较运算符指明有效版本范围。可用操作符如下:>>=<<=!=

可以定义多个范围,使用空格( )或者逗号(,)分隔的范围当做逻辑与操作,使用双管道(||)分隔的范围当做逻辑或操作。

  • >=1.0
  • >=1.0 <2.0
  • >=1.0 <1.1 || >=1.2

带连字符的范围

非完整的版本号会用通配符补全,比如 2.0 补全为 2.0.*

  • 1.0 - 2.0 等价于 >=1.0 <2.1
  • 1.0.0 - 2.1.0 等价于 >=1.0.0 <=2.1.0

通配符

可以在版本号中使用通配符(*)。

  • 1.0.* 等价于 >=1.0 <1.1

下一个重要版本

对于遵循语义化版本的项目,波浪号和脱字符提供更加简介的表达。

波浪号(~)

波浪号常用于标记依赖包的最小版本。可以理解为波浪号标记依赖包的最低版本,并允许版本号最后一位数字增加(不适用于主版本号)。

  • ~1.2 等价于 >=1.2 <2.0.0
  • ~1.2.3 等价于 >=1.2.3 <1.3.0

脱字符(^)

脱字符的行为和波浪号类似,但更强调语义化版本,总是允许向后兼容的更新。

  • ^1.2.3 等价于 >=1.2.3 <2.0.0

不过,对于早于1.0的版本,脱字符处理逻辑如下:

  • ^0.3 等价于 >=0.3 <0.4

注:为了最大化互操作性,对于库类型的项目,推荐使用脱字符声明依赖包的版本。

稳定性

如果版本约束中没有显式定义稳定性,Composer 内部会根据操作符的不同,默认附加 -dev 或者 -stable。如果你希望只安装稳定版本,请在使用 -stable 后缀。

约束 内部
1.2.3 =1.2.3-stable
>1.2 >1.2.0.0-stable
>=1.2 >=1.2.0.0-dev
>=1.2-stable >=1.2.0.0-stable
<1.3 <1.3.0.0-dev
<=1.3 <=1.3.0.0-stable
1 - 2 >=1.0.0.0-dev <3.0.0.0-dev
~1.3 >=1.3.0.0-dev <2.0.0.0-dev
1.4.* >=1.4.0.0-dev <1.5.0.0-dev

参考

分享到: 更多

Leave a Reply

Your email address will not be published. Required fields are marked *

*

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>