]>
Commit | Line | Data |
---|---|---|
4f5b44bd NL |
1 | <?php |
2 | ||
3 | /* | |
4 | * This file is part of the Symfony package. | |
5 | * | |
6 | * (c) Fabien Potencier <fabien@symfony.com> | |
7 | * | |
8 | * For the full copyright and license information, please view the LICENSE | |
9 | * file that was distributed with this source code. | |
10 | */ | |
11 | ||
12 | namespace Symfony\Component\Intl\Util; | |
13 | ||
14 | /** | |
15 | * Facilitates the comparison of version strings. | |
16 | * | |
17 | * @author Bernhard Schussek <bschussek@gmail.com> | |
18 | */ | |
19 | class Version | |
20 | { | |
21 | /** | |
22 | * Compares two versions with an operator. | |
23 | * | |
24 | * This method is identical to {@link version_compare()}, except that you | |
25 | * can pass the number of regarded version components in the last argument | |
26 | * $precision. | |
27 | * | |
28 | * Examples: | |
29 | * | |
30 | * Version::compare('1.2.3', '1.2.4', '==') | |
31 | * // => false | |
32 | * | |
33 | * Version::compare('1.2.3', '1.2.4', '==', 2) | |
34 | * // => true | |
35 | * | |
36 | * @param string $version1 A version string. | |
37 | * @param string $version2 A version string to compare. | |
38 | * @param string $operator The comparison operator. | |
39 | * @param integer|null $precision The number of components to compare. Pass | |
40 | * NULL to compare the versions unchanged. | |
41 | * | |
42 | * @return Boolean Whether the comparison succeeded. | |
43 | * | |
44 | * @see normalize() | |
45 | */ | |
46 | public static function compare($version1, $version2, $operator, $precision = null) | |
47 | { | |
48 | $version1 = self::normalize($version1, $precision); | |
49 | $version2 = self::normalize($version2, $precision); | |
50 | ||
51 | return version_compare($version1, $version2, $operator); | |
52 | } | |
53 | ||
54 | /** | |
55 | * Normalizes a version string to the number of components given in the | |
56 | * parameter $precision. | |
57 | * | |
58 | * Examples: | |
59 | * | |
60 | * Version::normalize('1.2.3', 1); | |
61 | * // => '1' | |
62 | * | |
63 | * Version::normalize('1.2.3', 2); | |
64 | * // => '1.2' | |
65 | * | |
66 | * @param string $version A version string. | |
67 | * @param integer|null $precision The number of components to include. Pass | |
68 | * NULL to return the version unchanged. | |
69 | * | |
70 | * @return string|null The normalized version or NULL if it couldn't be | |
71 | * normalized. | |
72 | */ | |
73 | public static function normalize($version, $precision) | |
74 | { | |
75 | if (null === $precision) { | |
76 | return $version; | |
77 | } | |
78 | ||
79 | $pattern = '[^\.]+'; | |
80 | ||
81 | for ($i = 2; $i <= $precision; ++$i) { | |
82 | $pattern = sprintf('[^\.]+(\.%s)?', $pattern); | |
83 | } | |
84 | ||
85 | if (!preg_match('/^' . $pattern . '/', $version, $matches)) { | |
86 | return null; | |
87 | } | |
88 | ||
89 | return $matches[0]; | |
90 | } | |
91 | ||
92 | /** | |
93 | * Must not be instantiated. | |
94 | */ | |
95 | private function __construct() {} | |
96 | } |