ilDatabaseSetupAgent.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
use ILIAS\Setup\Agent;
use ILIAS\Setup\Agent\HasNoNamedObjective;
use ILIAS\Setup\Config;
use ILIAS\Setup\Objective;
use ILIAS\Setup\Objective\NullObjective;
use ILIAS\Setup\ObjectiveCollection;
use ILIAS\Setup\Metrics\Storage;
use ILIAS\Setup\ilMysqlMyIsamToInnoDbMigration;
use ILIAS\Setup\ObjectiveConstructor;
use ILIAS\Refinery\Factory as Refinery;
use ILIAS\Refinery\Transformation;
use ILIAS\Setup\Objective\CalledFromRootObjective;
 
class ilDatabaseSetupAgent implements Agent
{
    use HasNoNamedObjective;
 
    public function __construct(protected Refinery $refinery)
    {
    }
 
    public function hasConfig(): bool
    {
        return true;
    }
 
    public function getArrayToConfigTransformation(): Transformation
    {
        // TODO: Migrate this to refinery-methods once possible.
        return $this->refinery->custom()->transformation(function ($data): \ilDatabaseSetupConfig {
            $data["password"] ??= null; // password can be empty
            $password = $this->refinery->to()->data("password");
            return new \ilDatabaseSetupConfig(
                $data["type"] ?? "innodb",
                $data["host"] ?? "localhost",
                $data["database"] ?? "ilias",
                $data["user"] ?? null,
                $data["password"] ? $password->transform($data["password"]) : null,
                $data["create_database"] ?? true,
                $data["collation"] ?? null,
                (int) ($data["port"] ?? 3306),
                $data["path_to_db_dump"] ?? null
            );
        });
    }
 
    public function getInstallObjective(?Config $config = null): Objective
    {
        if (!$config instanceof \ilDatabaseSetupConfig) {
            return new NullObjective();
        }
        return new ObjectiveCollection(
            "Complete objectives from Services\Database",
            false,
            new CalledFromRootObjective(),
            new ilDatabaseConfigStoredObjective($config),
            new ilDatabaseEnvironmentValidObjective(),
            new \ilDatabaseUpdatedObjective()
        );
    }
 
    public function getUpdateObjective(?Config $config = null): Objective
    {
        $p = [];
        $p[] = new CalledFromRootObjective();
        $p[] = new \ilDatabaseUpdatedObjective();
        $p[] = new ilDatabaseEnvironmentValidObjective();
        return new ObjectiveCollection(
            "Complete objectives from Services\Database",
            false,
            ...$p
        );
    }
 
    public function getBuildObjective(): Objective
    {
        return new NullObjective();
    }
 
    public function getStatusObjective(Storage $storage): Objective
    {
        return new ilDatabaseMetricsCollectedObjective($storage);
    }
 
    public function getMigrations(): array
    {
        return [
            new ilMysqlMyIsamToInnoDbMigration()
        ];
    }
 
    public function getNamedObjectives(?Config $config = null): array
    {
        return [
            'resetFailedSteps' => new ObjectiveConstructor(
                'reset null-states in il_db_steps',
                static fn(): Objective => new ilDatabaseResetStepsObjective()
            )
        ];
    }
}