class.ilNoVersionDowngradeConditionObjective.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

use ILIAS\Setup;
use ILIAS\Data;

class ilNoVersionDowngradeConditionObjective 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 downgrade is performed.";
    }

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

        $current_version = $this->data_factory->version($settings->get(ilVersionWrittenToSettingsObjective::ILIAS_VERSION_KEY));
        $target_version = $this->data_factory->version(ILIAS_VERSION_NUMERIC);

        if ($target_version->isSmallerThan($current_version)) {
            throw new Setup\NotExecutableException(
                "Downgrades of versions may not be performed, you are running " .
                "$current_version and target $target_version"
            );
        }

        return $environment;
    }

    public function isApplicable(Setup\Environment $environment): bool
    {
        return true;
    }
}