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 );