class.ilSetupAgent.php

Go to the documentation of this file.

<?php
 
/* Copyright (c) 2019 Richard Klees <richard.klees@concepts-and-training.de> Extended GPL, see docs/LICENSE */
 
use ILIAS\Setup;
use ILIAS\Refinery;
use ILIAS\Data;
use ILIAS\UI;
 
class ilSetupAgent implements Setup\Agent
{
    const PHP_MEMORY_LIMIT = "128M";
 
    protected $refinery;
 
    protected $data;
 
    public function __construct(
        Refinery\Factory $refinery,
        Data\Factory $data
    ) {
        $this->refinery = $refinery;
        $this->data = $data;
    }
 
    public function hasConfig() : bool
    {
        return true;
    }
 
    public function getArrayToConfigTransformation() : Refinery\Transformation
    {
        return $this->refinery->custom()->transformation(function ($data) {
            $datetimezone = $this->refinery->to()->toNew(\DateTimeZone::class);
            return new \ilSetupConfig(
                $this->data->clientId($data["client_id"] ?? ''),
                $datetimezone->transform([$data["server_timezone"] ?? "UTC"]),
                $data["register_nic"] ?? false
            );
        });
    }
 
    public function getInstallObjective(Setup\Config $config = null) : Setup\Objective
    {
        return new Setup\Objective\ObjectiveWithPreconditions(
            new \ilMakeInstallationAccessibleObjective($config),
            new \ilOverwritesExistingInstallationConfirmed($config),
            new Setup\ObjectiveCollection(
                "Complete common ILIAS objectives.",
                false,
                new Setup\Condition\PHPVersionCondition("7.2.0"),
                new Setup\Condition\PHPExtensionLoadedCondition("dom"),
                new Setup\Condition\PHPExtensionLoadedCondition("xsl"),
                new Setup\Condition\PHPExtensionLoadedCondition("gd"),
                $this->getPHPMemoryLimitCondition(),
                new ilSetupConfigStoredObjective($config, true),
                $config->getRegisterNIC()
                        ? new ilNICKeyRegisteredObjective($config)
                        : new Setup\ObjectiveCollection(
                            "",
                            false,
                            new ilNICKeyStoredObjective($config),
                            new ilInstIdDefaultStoredObjective($config)
                        )
            )
        );
    }
 
    protected function getPHPMemoryLimitCondition() : Setup\Objective
    {
        return new Setup\Condition\ExternalConditionObjective(
            "PHP memory limit >= " . self::PHP_MEMORY_LIMIT,
            function (Setup\Environment $env) : bool {
                $limit = ini_get("memory_limit");
                if ($limit == -1) {
                    return true;
                }
                $expected = $this->data->dataSize(self::PHP_MEMORY_LIMIT);
                $current = $this->data->dataSize($limit);
                return $current->inBytes() >= $expected->inBytes();
            },
            "To properly execute ILIAS, please take care that the PHP memory limit is at least set to 128M."
        );
    }
 
    public function getUpdateObjective(Setup\Config $config = null) : Setup\Objective
    {
        if ($config !== null) {
            return new ilSetupConfigStoredObjective($config);
        }
        return new Setup\Objective\NullObjective();
    }
 
    public function getBuildArtifactObjective() : Setup\Objective
    {
        return new Setup\Objective\NullObjective();
    }
 
    public function getStatusObjective(Setup\Metrics\Storage $storage) : Setup\Objective
    {
        return new ilSetupMetricsCollectedObjective($storage);
    }
 
    public function getMigrations() : array
    {
        return [];
    }
 
 
    public function getNamedObjective(string $name, Setup\Config $config = null) : Setup\Objective
    {
        if ($name == "registerNICKey") {
            if (is_null($config)) {
                throw new \RuntimeException(
                    "Missing Config for objective '$name'."
                );
            }
            return new ilNICKeyRegisteredObjective($config);
        }
        throw new \InvalidArgumentException(
            "There is no named objective '$name'"
        );
    }
}