ilSetupAgent Class Reference

Contains common objectives for the setup. More...

Inheritance diagram for ilSetupAgent:

Collaboration diagram for ilSetupAgent:

Public Member Functions
	__construct (Refinery\Factory $refinery, Data\Factory $data)
	hasConfig ()
	getArrayToConfigTransformation ()
	getInstallObjective (Setup\Config $config=null)
	getUpdateObjective (Setup\Config $config=null)
	getBuildArtifactObjective ()
	getStatusObjective (Setup\Metrics\Storage $storage)
	getMigrations ()
	@inheritDoc More...
	getNamedObjectives (?Config $config=null)

Protected Member Functions
	getPHPMemoryLimitCondition ()

Protected Attributes
Refinery Factory	$refinery
Data Factory	$data

Private Attributes
const	PHP_MEMORY_LIMIT = "128M"
const	PHP_MIN_VERSION = "7.4.0"
const	PHP_MAX_VERSION = "8.0.999"

Detailed Description

Contains common objectives for the setup.

Do not make additions here, in general all this stuff here is supposed to go elsewhere once we find out which service it really belongs to.

Definition at line 32 of file class.ilSetupAgent.php.

Constructor & Destructor Documentation

__construct()

ilSetupAgent::__construct	(	Refinery\Factory	$refinery,
		Data\Factory	$data
	)

Definition at line 41 of file class.ilSetupAgent.php.

      {
        $this->refinery = $refinery;
        $this->data = $data;
    }

References $data, $refinery, and ILIAS\Repository\refinery().

Here is the call graph for this function:

Member Function Documentation

getArrayToConfigTransformation()

ilSetupAgent::getArrayToConfigTransformation

(

)

Definition at line 60 of file class.ilSetupAgent.php.

                                                    : 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
            );
        });
    }

References $data, and ILIAS\Repository\refinery().

Here is the call graph for this function:

getBuildArtifactObjective()

ilSetupAgent::getBuildArtifactObjective

(

)

Definition at line 145 of file class.ilSetupAgent.php.

                                               : Setup\Objective
    {
        return new Setup\Objective\NullObjective();
    }

getInstallObjective()

ilSetupAgent::getInstallObjective

(

Setup\Config

$config = null

)

Definition at line 75 of file class.ilSetupAgent.php.

                                                                    : 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(self::PHP_MIN_VERSION, self::PHP_MAX_VERSION, true),
                new Setup\Condition\PHPExtensionLoadedCondition("dom"),
                new Setup\Condition\PHPExtensionLoadedCondition("xsl"),
                new Setup\Condition\PHPExtensionLoadedCondition("gd"),
                $this->getPHPMemoryLimitCondition(),
                new ilSetupConfigStoredObjective($config),
                $config->getRegisterNIC()
                    ? new ilNICKeyRegisteredObjective($config)
                    : new Setup\ObjectiveCollection(
                        "",
                        false,
                        new ilNICKeyStoredObjective($config),
                        new ilInstIdDefaultStoredObjective($config)
                    )
            )
        );
    }

References $config, and getPHPMemoryLimitCondition().

Here is the call graph for this function:

getMigrations()

ilSetupAgent::getMigrations

(

)

@inheritDoc

Definition at line 161 of file class.ilSetupAgent.php.

                                   : array
    {
        return [];
    }

getNamedObjectives()

ilSetupAgent::getNamedObjectives

(

?Config

$config = null

)

Definition at line 166 of file class.ilSetupAgent.php.

                                                              : array
    {
        return [
            "registerNICKey" => new Setup\ObjectiveConstructor(
                "Register NIC key",
                static function () use ($config): Setup\Objective {
                    if (is_null($config)) {
                        throw new \RuntimeException(
                            "Missing Config for objective 'registerNICKey'."
                        );
                    }
 
                    return new ilNICKeyRegisteredObjective($config);
                }
            )
        ];
    }

References $config.

getPHPMemoryLimitCondition()

ilSetupAgent::getPHPMemoryLimitCondition ( )

protected

Definition at line 101 of file class.ilSetupAgent.php.

                                                   : 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."
        );
    }

Referenced by getInstallObjective().

Here is the caller graph for this function:

getStatusObjective()

ilSetupAgent::getStatusObjective

(

Setup\Metrics\Storage

$storage

)

Definition at line 153 of file class.ilSetupAgent.php.

                                                                      : Setup\Objective
    {
        return new ilSetupMetricsCollectedObjective($storage);
    }

getUpdateObjective()

ilSetupAgent::getUpdateObjective

(

Setup\Config

$config = null

)

Definition at line 121 of file class.ilSetupAgent.php.

                                                                   : Setup\Objective
    {
        $objectives = [
            new Setup\Objective\ObjectiveWithPreconditions(
                new ilVersionWrittenToSettingsObjective($this->data),
                new Setup\Condition\PHPVersionCondition(self::PHP_MIN_VERSION, self::PHP_MAX_VERSION, true),
                new ilNoMajorVersionSkippedConditionObjective($this->data),
                new ilNoVersionDowngradeConditionObjective($this->data)
            )
        ];
        if ($config !== null) {
            $objectives[] = new ilSetupConfigStoredObjective($config);
        }
 
        return new Setup\ObjectiveCollection(
            "Complete common ILIAS objectives.",
            false,
            ...$objectives
        );
    }

References $config, and $objectives.

hasConfig()

ilSetupAgent::hasConfig

(

)

Definition at line 52 of file class.ilSetupAgent.php.

                               : bool
    {
        return true;
    }

Field Documentation

$data

Data Factory ilSetupAgent::$data

protected

Definition at line 39 of file class.ilSetupAgent.php.

Referenced by __construct(), and getArrayToConfigTransformation().

$refinery

Refinery Factory ilSetupAgent::$refinery

protected

Definition at line 38 of file class.ilSetupAgent.php.

Referenced by __construct().

PHP_MAX_VERSION

const ilSetupAgent::PHP_MAX_VERSION = "8.0.999"

private

Definition at line 36 of file class.ilSetupAgent.php.

PHP_MEMORY_LIMIT

const ilSetupAgent::PHP_MEMORY_LIMIT = "128M"

private

Definition at line 34 of file class.ilSetupAgent.php.

PHP_MIN_VERSION

const ilSetupAgent::PHP_MIN_VERSION = "7.4.0"

private

Definition at line 35 of file class.ilSetupAgent.php.

---

The documentation for this class was generated from the following file:

• setup/classes/class.ilSetupAgent.php