VersionNumberUtility.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Core\Utility;
 
use ‪TYPO3\CMS\Core\Information\Typo3Version;
 
class ‪VersionNumberUtility
{
    public static function ‪convertVersionNumberToInteger(string $versionNumber): int
    {
        $versionParts = explode('.', $versionNumber);
        $version = $versionParts[0];
        for ($i = 1; $i < 3; $i++) {
            if (!empty($versionParts[$i])) {
                $version .= str_pad((string)(int)$versionParts[$i], 3, '0', STR_PAD_LEFT);
            } else {
                $version .= '000';
            }
        }
        return (int)$version;
    }
 
    public static function ‪getNumericTypo3Version(): string
    {
        $t3version = static::getCurrentTypo3Version();
        $t3version = preg_replace('/-?(dev|alpha|beta|RC).*$/', '', $t3version);
        $parts = ‪GeneralUtility::intExplode('.', $t3version . '..');
        $t3version = ‪MathUtility::forceIntegerInRange($parts[0], 0, 999) . '.' .
            ‪MathUtility::forceIntegerInRange($parts[1], 0, 999) . '.' .
            ‪MathUtility::forceIntegerInRange($parts[2], 0, 999);
        return $t3version;
    }
 
    public static function ‪getCurrentTypo3Version(): string
    {
        return (string)GeneralUtility::makeInstance(Typo3Version::class);
    }
 
    public static function ‪convertVersionsStringToVersionNumbers(string $versionsString): array
    {
        $versions = ‪GeneralUtility::trimExplode('-', $versionsString);
        foreach ($versions as $i => $version) {
            $cleanedVersion = ‪GeneralUtility::trimExplode('.', $version);
            foreach ($cleanedVersion as $j => $cleaned) {
                $cleanedVersion[$j] = ‪MathUtility::forceIntegerInRange((int)$cleaned, 0, 999);
            }
            $cleanedVersionString = implode('.', $cleanedVersion);
            if (static::convertVersionNumberToInteger($cleanedVersionString) === 0) {
                $cleanedVersionString = '';
            }
            $versions[$i] = $cleanedVersionString;
        }
        return $versions;
    }
 
    public static function convertVersionStringToArray(string $version): array
    {
        $parts = ‪GeneralUtility::intExplode('.', $version . '..');
        $parts[0] = ‪MathUtility::forceIntegerInRange($parts[0], 0, 999);
        $parts[1] = ‪MathUtility::forceIntegerInRange($parts[1], 0, 999);
        $parts[2] = ‪MathUtility::forceIntegerInRange($parts[2], 0, 999);
        $result = [];
        $result['version'] = $parts[0] . '.' . $parts[1] . '.' . $parts[2];
        $result['version_int'] = (int)($parts[0] * 1000000 + $parts[1] * 1000 + $parts[2]);
        $result['version_main'] = $parts[0];
        $result['version_sub'] = $parts[1];
        $result['version_dev'] = $parts[2];
        return $result;
    }
}