TYPO3 CMS  TYPO3_7-6
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
TYPO3\CMS\Install\Service\CoreVersionService Class Reference

Public Member Functions

 injectObjectManager (\TYPO3\CMS\Extbase\Object\ObjectManager $objectManager)
 
 injectRegistry (\TYPO3\CMS\Core\Registry $registry)
 
 getDownloadBaseUri ()
 
 __construct ()
 
 updateVersionMatrix ()
 
 isInstalledVersionAReleasedVersion ()
 
 getTarGzSha1OfVersion ($version)
 
 getInstalledVersion ()
 
 isVersionActivelyMaintained ()
 
 isYoungerPatchReleaseAvailable ()
 
 isYoungerPatchDevelopmentReleaseAvailable ()
 
 isUpdateSecurityRelevant ()
 
 getYoungestPatchRelease ()
 
 getYoungestPatchDevelopmentRelease ()
 

Protected Member Functions

 getYoungestReleaseByType (array $types)
 
 getInstalledMajorVersion ()
 
 getMajorVersion ($version)
 
 getVersionMatrix ()
 
 fetchVersionMatrixFromRemote ()
 
 getReleaseTimestampOfVersion ($version)
 
 ensureVersionExistsInMatrix ($version)
 

Protected Attributes

 $objectManager
 
 $registry
 
 $downloadBaseUri
 

Detailed Description

Core version service

Definition at line 23 of file CoreVersionService.php.

Constructor & Destructor Documentation

◆ __construct()

TYPO3\CMS\Install\Service\CoreVersionService::__construct ( )

Initialize update URI

Definition at line 69 of file CoreVersionService.php.

Member Function Documentation

◆ ensureVersionExistsInMatrix()

TYPO3\CMS\Install\Service\CoreVersionService::ensureVersionExistsInMatrix (   $version)
protected

Throws an exception if specified version does not exist in version matrix

Parameters
$versionString to check in version matrix, e.g., 7.2.0alpha3 or 7.3.0
Exceptions
Exception

Definition at line 345 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\getMajorVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getVersionMatrix().

Referenced by TYPO3\CMS\Install\Service\CoreVersionService\getReleaseTimestampOfVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getTarGzSha1OfVersion().

◆ fetchVersionMatrixFromRemote()

TYPO3\CMS\Install\Service\CoreVersionService::fetchVersionMatrixFromRemote ( )
protected

Get available version string from get.typo3.org

Returns
array
Exceptions
Exception

Definition at line 303 of file CoreVersionService.php.

References TYPO3\CMS\Core\Utility\GeneralUtility\getUrl().

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

◆ getDownloadBaseUri()

TYPO3\CMS\Install\Service\CoreVersionService::getDownloadBaseUri ( )
Returns
mixed

Definition at line 61 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\$downloadBaseUri.

◆ getInstalledMajorVersion()

TYPO3\CMS\Install\Service\CoreVersionService::getInstalledMajorVersion ( )
protected

Get 'major version' from installed version of TYPO3, e.g., '7' from '7.3.0'

Returns
string For example 7

Definition at line 262 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\getInstalledVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getMajorVersion().

Referenced by TYPO3\CMS\Install\Service\CoreVersionService\isVersionActivelyMaintained(), and TYPO3\CMS\Install\Service\CoreVersionService\updateVersionMatrix().

◆ getInstalledVersion()

TYPO3\CMS\Install\Service\CoreVersionService::getInstalledVersion ( )

Get current installed version number

Returns
string

Definition at line 136 of file CoreVersionService.php.

References TYPO3\CMS\Core\Utility\VersionNumberUtility\getCurrentTypo3Version().

Referenced by TYPO3\CMS\Install\Service\CoreVersionService\getInstalledMajorVersion(), TYPO3\CMS\Install\Service\CoreVersionService\getYoungestReleaseByType(), TYPO3\CMS\Install\Service\CoreVersionService\isInstalledVersionAReleasedVersion(), TYPO3\CMS\Install\Service\CoreVersionService\isUpdateSecurityRelevant(), TYPO3\CMS\Install\Service\CoreVersionService\isYoungerPatchDevelopmentReleaseAvailable(), and TYPO3\CMS\Install\Service\CoreVersionService\isYoungerPatchReleaseAvailable().

◆ getMajorVersion()

TYPO3\CMS\Install\Service\CoreVersionService::getMajorVersion (   $version)
protected

Get 'major version' of version, e.g., '7' from '7.3.0'

Parameters
string$versionto check
Returns
string Major version, e.g., '7'

Definition at line 273 of file CoreVersionService.php.

Referenced by TYPO3\CMS\Install\Service\CoreVersionService\ensureVersionExistsInMatrix(), TYPO3\CMS\Install\Service\CoreVersionService\getInstalledMajorVersion(), TYPO3\CMS\Install\Service\CoreVersionService\getReleaseTimestampOfVersion(), TYPO3\CMS\Install\Service\CoreVersionService\getTarGzSha1OfVersion(), TYPO3\CMS\Install\Service\CoreVersionService\getYoungestReleaseByType(), and TYPO3\CMS\Install\Service\CoreVersionService\updateVersionMatrix().

◆ getReleaseTimestampOfVersion()

TYPO3\CMS\Install\Service\CoreVersionService::getReleaseTimestampOfVersion (   $version)
protected

Returns release timestamp of a specific version

Parameters
$versionString to check in version matrix, e.g., 7.2.0alpha3 or 7.3.0
Exceptions
Exception

Definition at line 323 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\ensureVersionExistsInMatrix(), TYPO3\CMS\Install\Service\CoreVersionService\getMajorVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getVersionMatrix().

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

◆ getTarGzSha1OfVersion()

TYPO3\CMS\Install\Service\CoreVersionService::getTarGzSha1OfVersion (   $version)

Get sha1 of a version from version matrix

Parameters
string$versionA version to get sha1 of
Returns
string sha1 of version
Exceptions
Exception

Definition at line 113 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\ensureVersionExistsInMatrix(), TYPO3\CMS\Install\Service\CoreVersionService\getMajorVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getVersionMatrix().

◆ getVersionMatrix()

TYPO3\CMS\Install\Service\CoreVersionService::getVersionMatrix ( )
protected

Get version matrix from registry

Returns
array
Exceptions
Exception

Definition at line 285 of file CoreVersionService.php.

Referenced by TYPO3\CMS\Install\Service\CoreVersionService\ensureVersionExistsInMatrix(), TYPO3\CMS\Install\Service\CoreVersionService\getReleaseTimestampOfVersion(), TYPO3\CMS\Install\Service\CoreVersionService\getTarGzSha1OfVersion(), TYPO3\CMS\Install\Service\CoreVersionService\getYoungestReleaseByType(), and TYPO3\CMS\Install\Service\CoreVersionService\isVersionActivelyMaintained().

◆ getYoungestPatchDevelopmentRelease()

TYPO3\CMS\Install\Service\CoreVersionService::getYoungestPatchDevelopmentRelease ( )

Youngest development patch release, e.g., 6.2.0alpha3 or 6.2-snapshot-20131004

Returns
string

Definition at line 212 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\getYoungestReleaseByType().

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

◆ getYoungestPatchRelease()

TYPO3\CMS\Install\Service\CoreVersionService::getYoungestPatchRelease ( )

Youngest patch release, e.g., 6.2.2

Returns
string Version string of youngest patch level release

Definition at line 202 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\getYoungestReleaseByType().

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

◆ getYoungestReleaseByType()

TYPO3\CMS\Install\Service\CoreVersionService::getYoungestReleaseByType ( array  $types)
protected

Get youngest release version string. Returns same version number if no younger release was found.

Parameters
array$typesList of allowed types: development, release, security, regular
Exceptions
Exception

Definition at line 225 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\getInstalledVersion(), TYPO3\CMS\Install\Service\CoreVersionService\getMajorVersion(), TYPO3\CMS\Install\Service\CoreVersionService\getReleaseTimestampOfVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getVersionMatrix().

Referenced by TYPO3\CMS\Install\Service\CoreVersionService\getYoungestPatchDevelopmentRelease(), TYPO3\CMS\Install\Service\CoreVersionService\getYoungestPatchRelease(), and TYPO3\CMS\Install\Service\CoreVersionService\isUpdateSecurityRelevant().

◆ injectObjectManager()

TYPO3\CMS\Install\Service\CoreVersionService::injectObjectManager ( \TYPO3\CMS\Extbase\Object\ObjectManager  $objectManager)
Parameters
\TYPO3\CMS\Extbase\Object\ObjectManager$objectManager

Definition at line 45 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\$objectManager.

◆ injectRegistry()

TYPO3\CMS\Install\Service\CoreVersionService::injectRegistry ( \TYPO3\CMS\Core\Registry  $registry)
Parameters
\TYPO3\CMS\Core\Registry$registry

Definition at line 53 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\$registry.

◆ isInstalledVersionAReleasedVersion()

TYPO3\CMS\Install\Service\CoreVersionService::isInstalledVersionAReleasedVersion ( )

Development git checkout versions always end with '-dev'. They are not "released" as such and can not be updated.

Returns
bool FALSE If some development version is installed

Definition at line 100 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\getInstalledVersion().

◆ isUpdateSecurityRelevant()

TYPO3\CMS\Install\Service\CoreVersionService::isUpdateSecurityRelevant ( )

Returns TRUE if an upgrade from current version is security relevant

Returns
bool TRUE if there is a pending security update

Definition at line 186 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\getInstalledVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getYoungestReleaseByType().

◆ isVersionActivelyMaintained()

TYPO3\CMS\Install\Service\CoreVersionService::isVersionActivelyMaintained ( )

Checks if TYPO3 version (e.g. 6.2) is an actively maintained version

Returns
bool TRUE if version is actively maintained

Definition at line 146 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\getInstalledMajorVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getVersionMatrix().

◆ isYoungerPatchDevelopmentReleaseAvailable()

TYPO3\CMS\Install\Service\CoreVersionService::isYoungerPatchDevelopmentReleaseAvailable ( )

Returns TRUE if a younger patch level release exists in version matrix that may be a development release.

Returns
bool TRUE if younger patch release is exists

Definition at line 170 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\getInstalledVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getYoungestPatchDevelopmentRelease().

◆ isYoungerPatchReleaseAvailable()

TYPO3\CMS\Install\Service\CoreVersionService::isYoungerPatchReleaseAvailable ( )

Returns TRUE if a younger patch level release exists in version matrix.

Returns
bool TRUE if younger patch release is exists

Definition at line 158 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\getInstalledVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getYoungestPatchRelease().

◆ updateVersionMatrix()

TYPO3\CMS\Install\Service\CoreVersionService::updateVersionMatrix ( )

Update version matrix from remote and store in registry

Returns
void
Exceptions
Exception

Definition at line 80 of file CoreVersionService.php.

References TYPO3\CMS\Install\Service\CoreVersionService\fetchVersionMatrixFromRemote(), TYPO3\CMS\Install\Service\CoreVersionService\getInstalledMajorVersion(), and TYPO3\CMS\Install\Service\CoreVersionService\getMajorVersion().

Member Data Documentation

◆ $downloadBaseUri

TYPO3\CMS\Install\Service\CoreVersionService::$downloadBaseUri
protected

Definition at line 40 of file CoreVersionService.php.

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

◆ $objectManager

TYPO3\CMS\Install\Service\CoreVersionService::$objectManager
protected

Definition at line 28 of file CoreVersionService.php.

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

◆ $registry

TYPO3\CMS\Install\Service\CoreVersionService::$registry
protected

Definition at line 33 of file CoreVersionService.php.

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