ILIAS\Setup\CLI\ConfigReader Class Reference

Read a json-formatted config from a file and overwrite some fields. More...

Collaboration diagram for ILIAS\Setup\CLI\ConfigReader:

Public Member Functions
	__construct (?string $base_dir=null)
	readConfigFile (string $name, array $overwrites=[])
	TODO: We could use the "give me a transformation and I'll give you your result" pattern from the input paper here. More...

Protected Member Functions
	applyOverwrites (array $json, array $overwrites)
	getRealFilename (string $name)

Protected Attributes
string	$base_dir

Detailed Description

Read a json-formatted config from a file and overwrite some fields.

Definition at line 34 of file ConfigReader.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Setup\CLI\ConfigReader::__construct

(

?string

$base_dir = null

)

Definition at line 38 of file ConfigReader.php.

    {
        $this->base_dir = $base_dir ?? getcwd();
    }

References ILIAS\Setup\CLI\ConfigReader\$base_dir.

Member Function Documentation

applyOverwrites()

ILIAS\Setup\CLI\ConfigReader::applyOverwrites ( array  $json, array  $overwrites  )

protected

Definition at line 75 of file ConfigReader.php.

                                                                      : array
    {
        $replacer = null;
        $replacer = function ($subject, $path, $value) use (&$replacer) {
            if (count($path) === 0) {
                return $value;
            }
            $cur = array_shift($path);
            $subject[$cur] = $replacer($subject[$cur] ?? [], $path, $value);
            return $subject;
        };
 
        foreach ($overwrites as $path => $value) {
            $path = explode(".", (string) $path);
            $json = $replacer($json, $path, $value);
        }
 
        return $json;
    }

References $path.

Referenced by ILIAS\Setup\CLI\ConfigReader\readConfigFile().

Here is the caller graph for this function:

getRealFilename()

ILIAS\Setup\CLI\ConfigReader::getRealFilename ( string  $name )

protected

Definition at line 95 of file ConfigReader.php.

                                                    : string
    {
        if (in_array($name[0], ["/", "\\"])) {
            return $name;
        }
        return $this->base_dir . "/" . $name;
    }

Referenced by ILIAS\Setup\CLI\ConfigReader\readConfigFile().

Here is the caller graph for this function:

readConfigFile()

ILIAS\Setup\CLI\ConfigReader::readConfigFile	(	string	$name,
		array	$overwrites = []
	)

TODO: We could use the "give me a transformation and I'll give you your result" pattern from the input paper here.

Parameters

array

$overwrites

is a list of fields that should be overwritten with with the contained variables. The keys define which field (e.g. "a.b.c") should be overwritten with which value.

Definition at line 52 of file ConfigReader.php.

                                                                        : array
    {
        $name = $this->getRealFilename($name);
        if (!is_readable($name)) {
            throw new \InvalidArgumentException(
                "Config-file '$name' does not exist or is not readable."
            );
        }
        $json = json_decode(
            file_get_contents($name),
            true,
            512,
            JSON_THROW_ON_ERROR
        );
 
        if (!is_array($json)) {
            throw new \InvalidArgumentException(
                "Could not find JSON-array in '$name'."
            );
        }
        return $this->applyOverwrites($json, $overwrites);
    }

References ILIAS\Setup\CLI\ConfigReader\applyOverwrites(), and ILIAS\Setup\CLI\ConfigReader\getRealFilename().

Here is the call graph for this function:

Field Documentation

$base_dir

string ILIAS\Setup\CLI\ConfigReader::$base_dir

protected

Definition at line 36 of file ConfigReader.php.

Referenced by ILIAS\Setup\CLI\ConfigReader\__construct().

---

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

• components/ILIAS/Setup/src/CLI/ConfigReader.php