semantic versioning.php

レインセマンティックバージョン

セマンティックバージョン2.0と互換性のあるセマンティックバージョンを解析および比較するための小さな独立したライブラリ。

依存関係

生産

• PHP 5.6以上

発達

• 作曲家
• git
• phpunit

設定

Composerをダウンロードして、 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オブジェクトを比較するためのセマンティックバージョンコンパレーター

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