TYPO3\CMS\Core\Utility\VersionNumberUtility Class Reference

Inheritance diagram for TYPO3\CMS\Core\Utility\VersionNumberUtility:

Static Public Member Functions
static int	convertVersionNumberToInteger ($versionNumber)
static string	convertIntegerToVersionNumber ($versionInteger)
static array	splitVersionRange ($version)
static string	getNumericTypo3Version ()
static string	getCurrentTypo3Version ()
static array	convertVersionsStringToVersionNumbers ($versionsString)
static array	convertVersionStringToArray ($version)
static string	raiseVersionNumber ($raise, $version)

Detailed Description

Class with helper functions for version number handling

Definition at line 24 of file VersionNumberUtility.php.

Member Function Documentation

convertIntegerToVersionNumber()

static string TYPO3\CMS\Core\Utility\VersionNumberUtility::convertIntegerToVersionNumber (   $versionInteger )

static

Returns the three part version number (string) from an integer, eg 4012003 -> '4.12.3'

Parameters

int

$versionInteger

‪Integer representation of version number

Returns

‪string Version number as format x.x.x

Exceptions

Definition at line 54 of file VersionNumberUtility.php.

Referenced by TYPO3\CMS\Core\Tests\UnitDeprecated\Utility\VersionNumberUtilityTest\convertIntegerToVersionNumberConvertsIntegerToVersionNumber(), and TYPO3\CMS\Core\Tests\UnitDeprecated\Utility\VersionNumberUtilityTest\convertIntegerToVersionNumberConvertsOtherTypesAsIntegerToVersionNumber().

convertVersionNumberToInteger()

static int TYPO3\CMS\Core\Utility\VersionNumberUtility::convertVersionNumberToInteger (   $versionNumber )

static

Returns an integer from a three part version number, eg '4.12.3' -> 4012003

Parameters

string

$versionNumber

‪Version number on format x.x.x

Returns

‪int Integer version of version number (where each part can count to 999)

Definition at line 32 of file VersionNumberUtility.php.

Referenced by TYPO3\CMS\Core\Tests\UnitDeprecated\Utility\VersionNumberUtilityTest\convertVersionNumberToIntegerConvertsVersionNumbersToIntegers(), TYPO3\CMS\Core\ExpressionLanguage\FunctionsProvider\DefaultFunctionsProvider\getCompatVersionFunction(), TYPO3\CMS\Extensionmanager\Utility\ListUtility\getExtensionTerData(), TYPO3\CMS\Extensionmanager\Utility\DependencyUtility\getLowestAndHighestIntegerVersions(), and TYPO3\CMS\Extensionmanager\ViewHelpers\Typo3DependencyViewHelper\isVersionSuitable().

convertVersionsStringToVersionNumbers()

static array TYPO3\CMS\Core\Utility\VersionNumberUtility::convertVersionsStringToVersionNumbers (   $versionsString )

static

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

Parameters

string

$versionsString

Returns

‪array

Definition at line 137 of file VersionNumberUtility.php.

References TYPO3\CMS\Core\Utility\MathUtility\forceIntegerInRange(), and TYPO3\CMS\Core\Utility\GeneralUtility\trimExplode().

Referenced by TYPO3\CMS\Extensionmanager\Utility\ExtensionModelUtility\convertDependenciesToObjects(), and TYPO3\CMS\Core\Tests\Unit\Utility\VersionNumberUtilityTest\convertVersionsStringToVersionNumbersForcesVersionNumberInRange().

convertVersionStringToArray()

static array TYPO3\CMS\Core\Utility\VersionNumberUtility::convertVersionStringToArray (   $version )

static

Parses the version number x.x.x and returns an array with the various parts. It also forces each … 0 to 999

Parameters

string

$version

‪Version code, x.x.x

Returns

‪array

Definition at line 163 of file VersionNumberUtility.php.

References TYPO3\CMS\Core\Utility\MathUtility\forceIntegerInRange(), and TYPO3\CMS\Core\Utility\GeneralUtility\intExplode().

Referenced by TYPO3\CMS\Extensionmanager\Utility\Importer\ExtensionListUtility\loadIntoDatabase().

getCurrentTypo3Version()

static string TYPO3\CMS\Core\Utility\VersionNumberUtility::getCurrentTypo3Version ( )

static

Wrapper function for TYPO3_version constant to make functions using the constant unit testable

Returns

‪string

Reimplemented in TYPO3\CMS\Core\Tests\Unit\Utility\Fixtures\VersionNumberUtilityFixture.

Definition at line 124 of file VersionNumberUtility.php.

getNumericTypo3Version()

static string TYPO3\CMS\Core\Utility\VersionNumberUtility::getNumericTypo3Version ( )

static

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

Returns

‪string

Definition at line 107 of file VersionNumberUtility.php.

References TYPO3\CMS\Core\Utility\MathUtility\forceIntegerInRange(), and TYPO3\CMS\Core\Utility\GeneralUtility\intExplode().

Referenced by TYPO3\CMS\Extensionmanager\Utility\DependencyUtility\checkTypo3Dependency(), TYPO3\CMS\Install\UpgradeAnalysis\DocumentationFile\findDocumentationDirectories(), TYPO3\CMS\Install\Tests\Unit\UpgradeAnalysis\DocumentationFileTest\findDocumentationFilesReturnsArrayOfFilesForTheLastThreeMajorVersions(), TYPO3\CMS\Core\Tests\Unit\Utility\VersionNumberUtilityTest\getNumericTypo3VersionNumber(), TYPO3\CMS\Extensionmanager\ViewHelpers\Typo3DependencyViewHelper\isVersionSuitable(), and TYPO3\CMS\Install\Tests\Unit\UpgradeAnalysis\DocumentationFileTest\setUp().

raiseVersionNumber()

static string TYPO3\CMS\Core\Utility\VersionNumberUtility::raiseVersionNumber (   $raise,   $version  )

static

Method to raise a version number

Parameters

string	$raise	‪one of "main", "sub", "dev" - the version part to raise by one
string	$version	‪(like 4.1.20)

Returns

‪string

Exceptions

Definition at line 187 of file VersionNumberUtility.php.

References TYPO3\CMS\Core\Utility\MathUtility\forceIntegerInRange(), and TYPO3\CMS\Core\Utility\GeneralUtility\intExplode().

splitVersionRange()

static array TYPO3\CMS\Core\Utility\VersionNumberUtility::splitVersionRange (   $version )

static

Splits a version range into an array.

If a single version number is given, it is considered a minimum value. If a dash is found, the numbers left and right are considered as minimum and maximum. Empty values are allowed. If no version can be parsed "0.0.0" — "0.0.0" is the result

Parameters

string

$version

‪A string with a version range.

Returns

‪array

Deprecated:

Definition at line 81 of file VersionNumberUtility.php.