semantic versioning.php

rayne semanistinging

一个小型独立库，用于解析和比较语义版本，该版本与语义版本兼容2.0。

依赖性

生产

• PHP 5.6或更好

发展

• 作曲家
• git
• phpunit

设置

下载作曲家并安装rayne/semantic-versioning 。

 composer require rayne/semantic-versioning

测试

1. 克隆存储库

    git clone https://github.com/rayne/semantic-versioning.php.git
   

2. 安装开发依赖性

    composer install --dev
   

3. 运行测试

    ./vendor/bin/phpunit
   

例子

该库包含以下类：

• InvalidVersionException ：通过无效输入的SemanticVersion抛出

• SemanticComparator ：用于比较SemanticVersion versication对象的语义版本控制比较器

• SemanticVersion ：语义版本控制解析器，在无效版本上抛出RuntimeException

这些例子是测试套件的一部分。请查看tests目录以获取更多信息。

解释语义版本

 use Rayne  SemanticVersioning  SemanticVersion ;

$ version = new SemanticVersion ( ' 1.0.0-beta+exp.sha.5114f85 ' );

assert ( ' 1.0.0-beta+exp.sha.5114f85 ' === ( string ) $ version );
assert ( 1                           === $ version -> getMajor ());
assert (   0                         === $ version -> getMinor ());
assert (     0                       === $ version -> getPatch ());
assert (      ' beta '                 === $ version -> getPre ());
assert (           ' exp.sha.5114f85 ' === $ version -> getMeta ());
assert ( ' 1.0.0-beta+exp.sha.5114f85 ' === $ version -> getVersion ());

assert ( true  === $ version -> isMajorRelease ());
assert ( false === $ version -> isMinorRelease ());
assert ( false === $ version -> isPatchRelease ());
assert ( true  === $ version -> isPreRelease ());

比较语义版本

 use Rayne  SemanticVersioning  SemanticComparator ;
use Rayne  SemanticVersioning  SemanticVersion ;

$ comparator     = new SemanticComparator ;

$ alpha          = new SemanticVersion ( ' 1.0.0-alpha ' );
$ candidate      = new SemanticVersion ( ' 1.0.0-rc.1 ' );
$ candidate_meta = new SemanticVersion ( ' 1.0.0-rc.1+ci ' );
$ release        = new SemanticVersion ( ' 1.0.0 ' );

// $alpha < $candidate
assert ( $ comparator ( $ alpha , $ candidate ) < 0 );
assert ( $ comparator -> compare ( $ alpha , $ candidate ) < 0 );

// $candidate == $candidate_meta
assert ( $ comparator ( $ candidate , $ candidate_meta ) == 0 );
assert ( $ comparator -> compare ( $ candidate , $ candidate_meta ) == 0 );

// $release > $candidate
assert ( $ comparator ( $ release , $ candidate ) > 0 );
assert ( $ comparator -> compare ( $ release , $ candidate ) > 0 );

排序语义版本

 use Rayne  SemanticVersioning  SemanticComparator ;
use Rayne  SemanticVersioning  SemanticVersion ;

$ versions = [
	$ candidate = new SemanticVersion ( ' 1.0.0-rc.1 ' ),
	$ release   = new SemanticVersion ( ' 1.0.0 ' ),
	$ alpha     = new SemanticVersion ( ' 1.0.0-alpha ' ),
];

// Sort by semantic precedence.
usort ( $ versions , new SemanticComparator );

assert ( $ versions [ 0 ] === $ alpha );
assert ( $ versions [ 1 ] === $ candidate );
assert ( $ versions [ 2 ] === $ release );