CoreVersionService.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Install\Service;

use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Core\Utility\VersionNumberUtility;

class CoreVersionService {

    protected $objectManager;

    protected $registry;

    protected $downloadBaseUri;

    public function getDownloadBaseUri() {
        return $this->downloadBaseUri;
    }

    public function __construct() {
        $this->downloadBaseUri = 'https://get.typo3.org/';
    }

    public function updateVersionMatrix() {
        $versionArray = $this->fetchVersionMatrixFromRemote();
        // This is a 'hack' to keep the string stored in the registry small. We are usually only
        // interested in information from 6.2 and up and older releases do not matter in current
        // use cases. If this unset() is removed and everything is stored for some reason, the
        // table sys_file field entry_value needs to be extended from blob to longblob.
        unset($versionArray['6.1'], $versionArray['6.0'], $versionArray['4.7'], $versionArray['4.6'],
            $versionArray['4.5'], $versionArray['4.4'], $versionArray['4.3'], $versionArray['4.2'],
            $versionArray['4.1'], $versionArray['4.0'], $versionArray['3.8'], $versionArray['3.7'],
            $versionArray['3.6'], $versionArray['3.5'], $versionArray['3.3']);
        $this->registry->set('TYPO3.CMS.Install', 'coreVersionMatrix', $versionArray);
    }

    public function isInstalledVersionAReleasedVersion() {
        $version = $this->getInstalledVersion();
        return substr($version, -4) !== '-dev';
    }

    public function getTarGzSha1OfVersion($version) {
        $this->ensureVersionExistsInMatrix($version);

        $minorVersion = $this->getMinorVersion($version);
        $versionMatrix = $this->getVersionMatrix();

        if (empty($versionMatrix[$minorVersion]['releases'][$version]['checksums']['tar']['sha1'])) {
            throw new Exception\CoreVersionServiceException(
                'Release sha1 of version ' . $version . ' not found in version matrix.'
                . ' This is probably a bug on get.typo3.org.',
                1381263173
            );
        }

        return $versionMatrix[$minorVersion]['releases'][$version]['checksums']['tar']['sha1'];
    }

    public function getInstalledVersion() {
        return VersionNumberUtility::getCurrentTypo3Version();
    }

    public function isYoungerPatchReleaseAvailable() {
        $result = FALSE;
        $version = $this->getInstalledVersion();
        $youngestVersion = $this->getYoungestPatchRelease();
        if ($youngestVersion !== $version) {
            $result = TRUE;
        }
        return $result;
    }

    public function isYoungerPatchDevelopmentReleaseAvailable() {
        $result = FALSE;
        $version = $this->getInstalledVersion();
        $youngestVersion = $this->getYoungestPatchDevelopmentRelease();
        if ($youngestVersion !== $version) {
            $result = TRUE;
        }
        return $result;
    }

    public function isUpdateSecurityRelevant() {
        $result = FALSE;
        $version = $this->getInstalledVersion();
        $youngestVersion = $this->getYoungestReleaseByType(array('security'));
        if ($youngestVersion !== $version) {
            $result = TRUE;
        }
        return $result;
    }

    public function getYoungestPatchRelease() {
        return $this->getYoungestReleaseByType(array('release', 'security', 'regular'));
    }

    public function getYoungestPatchDevelopmentRelease() {
        return $this->getYoungestReleaseByType(array('release', 'security', 'regular', 'development'));
    }

    protected function getYoungestReleaseByType(array $types) {
        $version = $this->getInstalledVersion();

        $minorVersion = $this->getMinorVersion($version);
        $versionMatrix = $this->getVersionMatrix();

        $youngestRelease = $version;
        $versionReleaseTimestamp = $this->getReleaseTimestampOfVersion($version);

        $patchLevelVersions = $versionMatrix[$minorVersion]['releases'];
        foreach ($patchLevelVersions as $aVersionNumber => $aVersionDetails) {
            if (!array_key_exists('type', $aVersionDetails)) {
                throw new Exception\CoreVersionServiceException(
                    'Release type of version ' . $aVersionNumber . ' not found in version matrix.'
                        . ' This is probably a bug on get.typo3.org.',
                    1380909029
                );
            }
            $type = $aVersionDetails['type'];
            $aVersionNumberReleaseTimestamp = $this->getReleaseTimestampOfVersion($aVersionNumber);
            if (
                $aVersionNumberReleaseTimestamp > $versionReleaseTimestamp
                && in_array($type, $types)
            ) {
                $youngestRelease = $aVersionNumber;
                $versionReleaseTimestamp = $aVersionNumberReleaseTimestamp;
            }
        }
        return $youngestRelease;
    }

    protected function getInstalledMinorVersion() {
        return $this->getMinorVersion($this->getInstalledVersion());
    }

    protected function getMinorVersion($version) {
        $explodedVersion = explode('.', $version);
        $minor = explode('-', $explodedVersion[1]);
        return $explodedVersion[0] . '.' . $minor[0];
    }

    protected function getVersionMatrix() {
        $versionMatrix = $this->registry->get('TYPO3.CMS.Install', 'coreVersionMatrix');
        if (empty($versionMatrix) || !is_array($versionMatrix)) {
            throw new Exception\CoreVersionServiceException(
                'No version matrix found in registry, call updateVersionMatrix() first.',
                1380898792
            );
        }
        return $versionMatrix;
    }

    protected function fetchVersionMatrixFromRemote() {
        $url = $this->downloadBaseUri . 'json';
        $versionJson = GeneralUtility::getUrl($url);
        if (!$versionJson) {
            throw new Exception\RemoteFetchException(
                'Fetching ' . $url . ' failed. Maybe this instance can not connect to the remote system properly.',
                1380897593
            );
        }
        return json_decode($versionJson, TRUE);
    }

    protected function getReleaseTimestampOfVersion($version) {
        $minorVersion = $this->getMinorVersion($version);
        $versionMatrix = $this->getVersionMatrix();
        $this->ensureVersionExistsInMatrix($version);
        if (!array_key_exists('date', $versionMatrix[$minorVersion]['releases'][$version])) {
            throw new Exception\CoreVersionServiceException(
                'Release date of version ' . $version . ' not found in version matrix. This is probably a bug on get.typo3.org',
                1380905853
            );
        }
        $dateString = $versionMatrix[$minorVersion]['releases'][$version]['date'];
        $date = new \DateTime($dateString);
        return $date->getTimestamp();
    }

    protected function ensureVersionExistsInMatrix($version) {
        $minorVersion = $this->getMinorVersion($version);
        $versionMatrix = $this->getVersionMatrix();
        if (!array_key_exists($minorVersion, $versionMatrix)) {
            throw new Exception\CoreVersionServiceException(
                'Minor release ' . $minorVersion . ' not found in version matrix.',
                1380905851
            );
        }
        if (!array_key_exists($version, $versionMatrix[$minorVersion]['releases'])) {
            throw new Exception\CoreVersionServiceException(
                'Patch level release ' . $version . ' not found in version matrix.',
                1380905852
            );
        }
    }
}