class.ilDatabaseResetStepsObjective.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

use ILIAS\Setup\Objective\AdminConfirmedObjective;
use ILIAS\Setup\Environment;
use ILIAS\Setup\Objective\ClientIdReadObjective;

class ilDatabaseResetStepsObjective extends AdminConfirmedObjective
{
    public function __construct()
    {
        parent::__construct(
            "This will reset failing steps in the setup progress. However -\n" .
            "those steps failed for a reason!\n" .
            "A step may fail due to a programming error, or, more likely, to some\n" .
            "circumstances in your environment, e.g. inconsistent data in the DB,\n" .
            "missing or unexpected files, etc.. Please double-check for the cause\n" .
            "and only continue if you are certain about and fine with the consequences.\n" .
            "Continue?"
        );
    }

    #[\Override]
    public function getHash(): string
    {
        return hash("sha256", self::class);
    }

    #[\Override]
    public function getLabel(): string
    {
        return "failing update steps are removed.";
    }

    #[\Override]
    public function isNotable(): bool
    {
        return true;
    }

    #[\Override]
    public function getPreconditions(Environment $environment): array
    {
        return [new ClientIdReadObjective(), new ilIniFilesPopulatedObjective(), new ilDatabaseInitializedObjective()];
    }

    #[\Override]
    public function achieve(Environment $environment): Environment
    {
        $environment = parent::achieve($environment);
        $db = $environment->getResource(Environment::RESOURCE_DATABASE);
        $db->manipulate('DELETE FROM il_db_steps WHERE finished IS NULL');
        return $environment;
    }

    #[\Override]
    public function isApplicable(Environment $environment): bool
    {
        $db = $environment->getResource(Environment::RESOURCE_DATABASE);
        $query = 'SELECT class FROM il_db_steps WHERE finished IS NULL';
        return $db->numRows($db->query($query)) > 0;
    }
}