[FEATURE] Add method to convert integer to version number
[Packages/TYPO3.CMS.git] / t3lib / utility / class.t3lib_utility_versionnumber.php
1 <?php
2 /***************************************************************
3 * Copyright notice
4 *
5 * (c) 2011 Susanne Moog <typo3@susanne-moog.de>
6 * All rights reserved
7 *
8 * This script is part of the TYPO3 project. The TYPO3 project is
9 * free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * The GNU General Public License can be found at
15 * http://www.gnu.org/copyleft/gpl.html.
16 * A copy is found in the textfile GPL.txt and important notices to the license
17 * from the author is found in LICENSE.txt distributed with these scripts.
18 *
19 *
20 * This script is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 * GNU General Public License for more details.
24 *
25 * This copyright notice MUST APPEAR in all copies of the script!
26 ***************************************************************/
27
28 /**
29 * Class with helper functions for version number handling
30 *
31 * @author Susanne Moog <typo3@susanne-moog.de>
32 * @package TYPO3
33 * @subpackage t3lib
34 */
35 final class t3lib_utility_VersionNumber {
36
37 /**
38 * Returns an integer from a three part version number, eg '4.12.3' -> 4012003
39 *
40 * @param $versionNumber string Version number on format x.x.x
41 * @return integer Integer version of version number (where each part can count to 999)
42 */
43 public static function convertVersionNumberToInteger($versionNumber) {
44 $versionParts = explode('.', $versionNumber);
45 return intval((int) $versionParts[0] . str_pad((int) $versionParts[1], 3, '0', STR_PAD_LEFT) . str_pad((int) $versionParts[2], 3, '0', STR_PAD_LEFT));
46 }
47
48 /**
49 * Returns the three part version number (string) from an integer, eg 4012003 -> '4.12.3'
50 *
51 * @param $versionInteger integer Integer representation of version number
52 * @return string Version number as format x.x.x
53 * @throws \InvalidArgumentException if $versionInteger is not an integer
54 */
55 public static function convertIntegerToVersionNumber($versionInteger) {
56 if (!is_int($versionInteger)) {
57 throw new \InvalidArgumentException(
58 't3lib_utility_VersionNumber::convertIntegerToVersionNumber() supports an integer argument only!',
59 1334072223
60 );
61 }
62
63 $versionString = str_pad($versionInteger, 9, '0', STR_PAD_LEFT);
64 $parts = array(
65 substr($versionString, 0, 3),
66 substr($versionString, 3, 3),
67 substr($versionString, 6, 3)
68 );
69 return intval($parts[0]) . '.' . intval($parts[1]) . '.' . intval($parts[2]);
70 }
71 }
72
73 ?>