CoreVersionService.php

Go to the documentation of this file.

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

/*
 * 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!
 */

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

class CoreVersionService
{
    protected $registry;

    protected $downloadBaseUri;

    public function __construct(Registry $registry = null)
    {
        $this->downloadBaseUri = 'https://get.typo3.org/';
        $this->registry = $registry ?: GeneralUtility::makeInstance(Registry::class);
    }

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

    public function updateVersionMatrix()
    {
        $versionArray = $this->fetchVersionMatrixFromRemote();
        $installedMajorVersion = (int)$this->getInstalledMajorVersion();

        foreach ($versionArray as $versionNumber => $versionDetails) {
            if (is_array($versionDetails) && (int)$this->getMajorVersion($versionNumber) < $installedMajorVersion) {
                unset($versionArray[$versionNumber]);
            }
        }

        $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);

        $majorVersion = $this->getMajorVersion($version);
        $versionMatrix = $this->getVersionMatrix();

        if (empty($versionMatrix[$majorVersion]['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[$majorVersion]['releases'][$version]['checksums']['tar']['sha1'];
    }

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

    public function isVersionActivelyMaintained()
    {
        $majorVersion = $this->getInstalledMajorVersion();
        $versionMatrix = $this->getVersionMatrix();
        return (bool)$versionMatrix[$majorVersion]['active'];
    }

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

    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(['security']);
        if ($youngestVersion !== $version) {
            $result = true;
        }
        return $result;
    }

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

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

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

        $majorVersion = $this->getMajorVersion($version);
        $versionMatrix = $this->getVersionMatrix();

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

        $patchLevelVersions = $versionMatrix[$majorVersion]['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 getInstalledMajorVersion()
    {
        return $this->getMajorVersion($this->getInstalledVersion());
    }

    protected function getMajorVersion($version)
    {
        $explodedVersion = explode('.', $version);
        return $explodedVersion[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)
    {
        $majorVersion = $this->getMajorVersion($version);
        $versionMatrix = $this->getVersionMatrix();
        $this->ensureVersionExistsInMatrix($version);
        if (!array_key_exists('date', $versionMatrix[$majorVersion]['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[$majorVersion]['releases'][$version]['date'];
        $date = new \DateTime($dateString);
        return $date->getTimestamp();
    }

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