class.ilNoMajorVersionSkippedConditionObjective.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
use ILIAS\Setup;
use ILIAS\Data;
 
class ilNoMajorVersionSkippedConditionObjective implements Setup\Objective
{
    protected Data\Factory $data_factory;
 
    public function __construct(Data\Factory $data_factory)
    {
        $this->data_factory = $data_factory;
    }
 
    public function getHash(): string
    {
        return hash(
            "sha256",
            get_class($this)
        );
    }
 
    public function getLabel(): string
    {
        return "No major version is skipped in update.";
    }
 
    public function isNotable(): bool
    {
        return true;
    }
 
    public function getPreconditions(Setup\Environment $environment): array
    {
        return [
            new ilSettingsFactoryExistsObjective()
        ];
    }
 
    public function achieve(Setup\Environment $environment): Setup\Environment
    {
        $factory = $environment->getResource(Setup\Environment::RESOURCE_SETTINGS_FACTORY);
        $settings = $factory->settingsFor("common");
 
        // TODO ILIAS 9: This special case can vanish with ILIAS 9. It exists to make sure that
        // installations on version 7.0 or greater can update to ILIAS 8. This is checked by
        // looking into the version string (which is only updated starting with 8 and had a
        // very old value previously) and the db_version (which is 5751 with ILIAS 7.0).
        $current_version_string = $settings->get(ilVersionWrittenToSettingsObjective::ILIAS_VERSION_KEY);
        if ($current_version_string === "3.2.3 2004-11-22" && (int) $settings->get("db_version") >= 5751) {
            return $environment;
        }
 
        $current_version = $this->data_factory->version($current_version_string);
        $target_version = $this->data_factory->version(ILIAS_VERSION_NUMERIC);
 
        if (($target_version->getMajor() - $current_version->getMajor()) > 1) {
            throw new Setup\NotExecutableException(
                "Updates may only be performed from one major version to the " .
                "next, no major versions may be skipped."
            );
        }
 
        return $environment;
    }
 
    public function isApplicable(Setup\Environment $environment): bool
    {
        return true;
    }
}