CoreVersionService.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * 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!
 */
 
namespace ‪TYPO3\CMS\Install\Service;
 
use ‪TYPO3\CMS\Core\Information\Typo3Version;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Install\CoreVersion\CoreRelease;
use ‪TYPO3\CMS\Install\CoreVersion\MaintenanceWindow;
use ‪TYPO3\CMS\Install\CoreVersion\MajorRelease;
use ‪TYPO3\CMS\Install\Service\Exception\RemoteFetchException;
 
class CoreVersionService
{
    protected $apiBaseUrl = 'https://get.typo3.org/api/v1/';
 
    public function isInstalledVersionAReleasedVersion(): bool
    {
        $version = $this->getInstalledVersion();
        return substr($version, -4) !== '-dev';
    }
 
    public function getInstalledVersion(): string
    {
        return (string)GeneralUtility::makeInstance(Typo3Version::class);
    }
 
    public function getMaintenanceWindow(): MaintenanceWindow
    {
        ‪$url = 'major/' . $this->getInstalledMajorVersion();
        $result = $this->fetchFromRemote(‪$url);
 
        return ‪MaintenanceWindow::fromApiResponse($result);
    }
 
    public function getSupportedMajorReleases(): array
    {
        ‪$url = 'major';
        $result = $this->fetchFromRemote(‪$url);
 
        $majorReleases = [
            'community' => [],
            'elts' => [],
        ];
        foreach ($result as $release) {
            $majorRelease = ‪MajorRelease::fromApiResponse($release);
            $maintenanceWindow = $majorRelease->getMaintenanceWindow();
 
            if ($maintenanceWindow->isSupportedByCommunity()) {
                $group = 'community';
            } elseif ($maintenanceWindow->isSupportedByElts()) {
                $group = 'elts';
            } else {
                // Major version is unsupported
                continue;
            }
 
            $majorReleases[$group][] = $majorRelease->getLts() ?? $majorRelease->getVersion();
        }
 
        return $majorReleases;
    }
 
    public function isPatchReleaseSuitableForUpdate(CoreRelease $coreRelease): bool
    {
        return version_compare($this->getInstalledVersion(), $coreRelease->getVersion()) === -1;
    }
 
    public function isUpdateSecurityRelevant(CoreRelease $releaseToCheck): bool
    {
        ‪$url = 'major/' . $this->getInstalledMajorVersion() . '/release';
        $result = $this->fetchFromRemote(‪$url);
 
        $installedVersion = $this->getInstalledVersion();
        foreach ($result as $release) {
            $coreRelease = ‪CoreRelease::fromApiResponse($release);
            if ($coreRelease->isSecurityUpdate()
                && version_compare($installedVersion, $coreRelease->getVersion()) === -1 // installed version is lower than release
                && version_compare($releaseToCheck->getVersion(), $coreRelease->getVersion()) > -1 // release to check is equal or higher than release
            ) {
                return true;
            }
        }
 
        return false;
    }
 
    public function isCurrentInstalledVersionElts(): bool
    {
        ‪$url = 'major/' . $this->getInstalledMajorVersion() . '/release';
        $result = $this->fetchFromRemote(‪$url);
 
        $installedVersion = $this->getInstalledVersion();
        foreach ($result as $release) {
            if (version_compare($installedVersion, $release['version']) === 0) {
                return $release['elts'] ?? false;
            }
        }
 
        return false;
    }
 
    public function getYoungestPatchRelease(): CoreRelease
    {
        ‪$url = 'major/' . $this->getInstalledMajorVersion() . '/release/latest';
        $result = $this->fetchFromRemote(‪$url);
        return ‪CoreRelease::fromApiResponse($result);
    }
 
    public function getYoungestCommunityPatchRelease(): CoreRelease
    {
        ‪$url = 'major/' . $this->getInstalledMajorVersion() . '/release';
        $result = $this->fetchFromRemote(‪$url);
 
        // Make sure all releases are sorted by their version
        $columns = array_column($result, 'version');
        array_multisort($columns, SORT_NATURAL, $result);
 
        // Remove any ELTS release
        $releases = array_filter($result, static function (array $release) {
            return ($release['elts'] ?? false) === false;
        });
 
        $latestRelease = end($releases);
 
        return ‪CoreRelease::fromApiResponse($latestRelease);
    }
 
    protected function fetchFromRemote(string ‪$url): array
    {
        ‪$url = $this->apiBaseUrl . ‪$url;
        $json = ‪GeneralUtility::getUrl(‪$url);
 
        if (!$json) {
            $this->throwFetchException(‪$url);
        }
        return json_decode($json, true);
    }
 
    protected function getInstalledMajorVersion(): string
    {
        return (string)GeneralUtility::makeInstance(Typo3Version::class)->getMajorVersion();
    }
 
    protected function throwFetchException(string ‪$url): void
    {
        throw new RemoteFetchException(
            'Fetching ' .
            ‪$url .
            ' failed. Maybe this instance can not connect to the remote system properly.',
            1380897593
        );
    }
}