requtize / semver-converter
Converts SemVer version (like Composer packages) into integer version with operators. Helps managing versions: store, compare, sort and retrive by conditions.
Requires
- php: ~5.5 || ~7.0 || ~8.0
- composer/semver: ^3.2
Requires (Dev)
- phpunit/phpunit: ^9.5
README
Converts SemVer version (like Composer packages) into integer version with operators. Helps managing versions: store, compare, sort and retrive by conditions.
Converter accepts the same versions as Composer, so You can use it with any package manager that accepts Semantic Versioning.
How it works?
For each version it uses Composer SemVer parser to parse version and normalize it. And then, for each version, converter creates array exploded by dot values. Each value pads with zeros and create from it long string which is converted to integer. And for each version we have big integer.
Sample:
- Version 1.0.5
- Normalize with SemVer: 1.0.5
- Explode: [ 1, 0, 5 ]
- Converts to strings and pad zeros: [ '001', '000', '005' ]
- Concatenate all strings: '001' + '000' + '005'
- Converts to integer: (int) '1000005'
Result: '1.0.5' == 1000005
Examples
Simple version
$result = (new SemVerConverter)->convert('0.1.0'); // Result array (size=1) 0 => array (size=2) 'from' => array (size=2) 0 => int 1000000 1 => string '==' (length=2) 'to' => array (size=2) 0 => int 1000000 1 => string '==' (length=2)
Version between
$result = (new SemVerConverter)->convert('>= 1.3.0 < 1.7.0'); // Result array (size=1) 0 => array (size=2) 'from' => array (size=2) 0 => int 1003000 1 => string '>=' (length=2) 'to' => array (size=2) 0 => int 1007000 1 => string '<' (length=1)
Tilde operator
$result = (new SemVerConverter)->convert('~1.3'); // Result array (size=1) 0 => array (size=2) 'from' => array (size=2) 0 => int 1003000 1 => string '>=' (length=2) 'to' => array (size=2) 0 => int 2000000 1 => string '<' (length=1)
Version or
$result = (new SemVerConverter)->convert('^1.9 || 3.0.*'); // Result array (size=2) 0 => array (size=2) 'from' => array (size=2) 0 => int 1009000 1 => string '>=' (length=2) 'to' => array (size=2) 0 => int 2000000 1 => string '<' (length=1) 1 => array (size=2) 'from' => array (size=2) 0 => int 3000000 1 => string '>=' (length=2) 'to' => array (size=2) 0 => int 3001000 1 => string '<' (length=1)
Settings
new SemVerConverter($zeros, $sections);
$zeros
Defines how meny zeros need to pad for each section of versions. It allows to define how long should be result.
$sections
Defines how many sections need to be generated from input. Default is 3, Composer SemVer generates 4. This also have an impact for result.
Licence
This code is licensed under MIT License.