TYPO3\CMS\Core\Utility\VersionNumberUtility Class Reference

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

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

Detailed Description

Class with helper functions for version number handling

Definition at line 20 of file VersionNumberUtility.php.

Member Function Documentation

convertIntegerToVersionNumber()

static 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 49 of file VersionNumberUtility.php.

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

convertVersionNumberToInteger()

static 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 28 of file VersionNumberUtility.php.

Referenced by TYPO3\CMS\Core\Utility\GeneralUtility\compat_version(), TYPO3\CMS\Core\Tests\Unit\Utility\VersionNumberUtilityTest\convertVersionNumberToIntegerConvertsVersionNumbersToIntegers(), TYPO3\CMS\Extensionmanager\Utility\ListUtility\getExtensionTerData(), TYPO3\CMS\Extensionmanager\Utility\DependencyUtility\getLowestAndHighestIntegerVersions(), TYPO3\CMS\Install\Report\InstallStatusReport\getRemainingUpdatesStatus(), TYPO3\CMS\Install\Controller\Action\Tool\UpgradeWizard\getUpdateObjectInstance(), TYPO3\CMS\Extensionmanager\ViewHelpers\Typo3DependencyViewHelper\isVersionSuitable(), TYPO3\CMS\Impexp\Import\loadInit(), and TYPO3\CMS\Lang\Domain\Model\Extension\setVersionFromString().

convertVersionsStringToVersionNumbers()

static 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 127 of file VersionNumberUtility.php.

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

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

convertVersionStringToArray()

static 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 153 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 TYPO3\CMS\Core\Utility\VersionNumberUtility::getCurrentTypo3Version ( )

static

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

Returns

string

Definition at line 114 of file VersionNumberUtility.php.

Referenced by TYPO3\CMS\Install\Service\CoreVersionService\getInstalledVersion().

getNumericTypo3Version()

static 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 97 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\Core\Tests\Unit\Utility\VersionNumberUtilityTest\getNumericTypo3VersionNumber(), and TYPO3\CMS\Extensionmanager\ViewHelpers\Typo3DependencyViewHelper\isVersionSuitable().

raiseVersionNumber()

static 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 176 of file VersionNumberUtility.php.

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

splitVersionRange()

static 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

Definition at line 73 of file VersionNumberUtility.php.