TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,117 @@
+<?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 with helper functions for version number handling
+ */
+class VersionNumberUtility
+{
+    /**
+     * Returns an integer from a three part version number, eg '4.12.3' -> 4012003
+     *
+     * @param string $versionNumber Version number on format x.x.x
+     * @return int Integer version of version number (where each part can count to 999)
+     */
+    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;
+    }
+
+    /**
+     * Removes -dev -alpha -beta -RC states (also without '-' prefix) from a version number
+     * and replaces them by .0 and normalizes to a three part version number
+     */
+    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;
+    }
+
+    /**
+     * Wrapper function for the static TYPO3 version to
+     * make functions using the constant unit testable.
+     */
+    public static function getCurrentTypo3Version(): string
+    {
+        return (string)GeneralUtility::makeInstance(Typo3Version::class);
+    }
+
+    /**
+     * This function converts version range strings (like '4.2.0-4.4.99') to an array
+     * (like array('4.2.0', '4.4.99'). It also forces each version part to be between
+     * 0 and 999
+     *
+     * @param string $versionsString A string in the form 'x.x.x-y.y.y'
+     * @return string[]
+     */
+    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;
+    }
+
+    /**
+     * Parses the version number x.x.x and returns an array with the various parts.
+     * It also forces each … 0 to 999
+     *
+     * @param string $version Version string, in the format x.x.x
+     * @return array<string, int|string>
+     */
+    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;
+    }
+}