ilCtrlStructure Class Reference

Class ilCtrlStructure holds the currently read control structure. More...

Inheritance diagram for ilCtrlStructure:

Collaboration diagram for ilCtrlStructure:

Public Member Functions
	__construct (array $ctrl_structure, array $base_classes, array $security_info)
	ilCtrlStructure Constructor More...
	isBaseClass (string $class_name)
	getObjNameByCid (string $cid)
	getObjNameByName (string $class_name)
	getClassNameByCid (string $cid)
	getClassCidByName (string $class_name)
	getRelativePathByName (string $class_name)
	getRelativePathByCid (string $cid)
	getChildrenByCid (string $cid)
	getChildrenByName (string $class_name)
	getParentsByCid (string $cid)
	getParentsByName (string $class_name)
	setPermanentParameterByClass (string $class_name, string $parameter_name)
	removePermanentParametersByClass (string $class_name)
	getPermanentParametersByClass (string $class_name)
	setTemporaryParameterByClass (string $class_name, string $parameter_name, $value)
	removeTemporaryParametersByClass (string $class_name)
	getTemporaryParametersByClass (string $class_name)
	removeSingleParameterByClass (string $class_name, string $parameter_name)
	setReturnTargetByClass (string $class_name, string $target_url)
	getReturnTargetByClass (string $class_name)
	getUnsafeCommandsByCid (string $cid)
	getUnsafeCommandsByName (string $class_name)
	getSafeCommandsByCid (string $cid)
	getSafeCommandsByName (string $class_name)

Private Member Functions
	getValueForKeyByCid (string $identifier_key, string $cid)
	Returns a stored structure value of the given key from the corresponding class mapped by CID. More...
	getValueForKeyByName (string $identifier_key, string $class_name)
	Returns a stored structure value of the given key from the corresponding class mapped by name. More...
	lowercase (string $string)
	Helper function to lowercase strings. More...

Private Attributes
const	PARAM_NAME_REGEX = '/^[A-Za-z0-9_-]*$/'
array	$temporary_parameters = []
array	$permanent_parameters = []
array	$return_targets = []
array	$structure
array	$base_classes
array	$security
array	$mapped_structure = []

Additional Inherited Members
Data Fields inherited from ilCtrlStructureInterface
const	KEY_CLASS_CID = 'cid'
	array key constants that are used for certain information. More...
const	KEY_CLASS_PATH = 'class_path'
const	KEY_CLASS_NAME = 'class_name'
const	KEY_CLASS_CID_PATHS = 'cid_paths'
const	KEY_CLASS_PARENTS = 'parents'
const	KEY_CLASS_CHILDREN = 'children'
const	KEY_UNSAFE_COMMANDS = 'unsafe_commands'
const	KEY_SAFE_COMMANDS = 'safe_commands'

Detailed Description

Class ilCtrlStructure holds the currently read control structure.

Author

Thibeau Fuhrer thf@s.nosp@m.tude.nosp@m.r-rai.nosp@m.mann.nosp@m..ch

Definition at line 12 of file class.ilCtrlStructure.php.

Constructor & Destructor Documentation

__construct()

ilCtrlStructure::__construct	(	array	$ctrl_structure,
		array	$base_classes,
		array	$security_info
	)

ilCtrlStructure Constructor

Parameters

array	$ctrl_structure
array	$base_classes
array	$security_info

Definition at line 71 of file class.ilCtrlStructure.php.

References $base_classes.

      {
        $this->base_classes = $base_classes;
        $this->security = $security_info;
        $this->structure = $ctrl_structure;
    }

Member Function Documentation

getChildrenByCid()

ilCtrlStructure::getChildrenByCid

(

string

$cid

)

Implements ilCtrlStructureInterface.

Definition at line 149 of file class.ilCtrlStructure.php.

References getValueForKeyByCid().

                                                 : ?array
    {
        $children = $this->getValueForKeyByCid(self::KEY_CLASS_CHILDREN, $cid);
        if (empty($children)) {
            return null;
        }

        return $children;
    }

Here is the call graph for this function:

getChildrenByName()

ilCtrlStructure::getChildrenByName

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 162 of file class.ilCtrlStructure.php.

References getValueForKeyByName().

                                                         : ?array
    {
        $children = $this->getValueForKeyByName(self::KEY_CLASS_CHILDREN, $class_name);
        if (empty($children)) {
            return null;
        }

        return $children;
    }

Here is the call graph for this function:

getClassCidByName()

ilCtrlStructure::getClassCidByName

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 125 of file class.ilCtrlStructure.php.

References getValueForKeyByName().

Referenced by isBaseClass().

                                                         : ?string
    {
        return $this->getValueForKeyByName(self::KEY_CLASS_CID, $class_name);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getClassNameByCid()

ilCtrlStructure::getClassNameByCid

(

string

$cid

)

Implements ilCtrlStructureInterface.

Definition at line 112 of file class.ilCtrlStructure.php.

References getValueForKeyByCid(), and lowercase().

Referenced by getSafeCommandsByCid(), and getUnsafeCommandsByCid().

                                                  : ?string
    {
        $class_name = $this->getValueForKeyByCid(
            self::KEY_CLASS_NAME,
            $cid
        );

        return (null !== $class_name) ? $this->lowercase($class_name) : null;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getObjNameByCid()

ilCtrlStructure::getObjNameByCid

(

string

$cid

)

Implements ilCtrlStructureInterface.

Definition at line 96 of file class.ilCtrlStructure.php.

References getValueForKeyByCid().

                                                : ?string
    {
        return $this->getValueForKeyByCid(self::KEY_CLASS_NAME, $cid);
    }

Here is the call graph for this function:

getObjNameByName()

ilCtrlStructure::getObjNameByName

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 104 of file class.ilCtrlStructure.php.

References getValueForKeyByName().

                                                        : ?string
    {
        return $this->getValueForKeyByName(self::KEY_CLASS_NAME, $class_name);
    }

Here is the call graph for this function:

getParentsByCid()

ilCtrlStructure::getParentsByCid

(

string

$cid

)

Implements ilCtrlStructureInterface.

Definition at line 175 of file class.ilCtrlStructure.php.

References getValueForKeyByCid().

                                                : ?array
    {
        $parents = $this->getValueForKeyByCid(self::KEY_CLASS_PARENTS, $cid);
        if (empty($parents)) {
            return null;
        }

        return $parents;
    }

Here is the call graph for this function:

getParentsByName()

ilCtrlStructure::getParentsByName

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 188 of file class.ilCtrlStructure.php.

References getValueForKeyByName().

                                                        : ?array
    {
        $parents = $this->getValueForKeyByName(self::KEY_CLASS_PARENTS, $class_name);
        if (empty($parents)) {
            return null;
        }

        return $parents;
    }

Here is the call graph for this function:

getPermanentParametersByClass()

ilCtrlStructure::getPermanentParametersByClass

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 228 of file class.ilCtrlStructure.php.

References lowercase().

                                                                     : ?array
    {
        return $this->permanent_parameters[$this->lowercase($class_name)] ?? null;
    }

Here is the call graph for this function:

getRelativePathByCid()

ilCtrlStructure::getRelativePathByCid

(

string

$cid

)

Implements ilCtrlStructureInterface.

Definition at line 141 of file class.ilCtrlStructure.php.

References getValueForKeyByCid().

                                                     : ?string
    {
        return $this->getValueForKeyByCid(self::KEY_CLASS_PATH, $cid);
    }

Here is the call graph for this function:

getRelativePathByName()

ilCtrlStructure::getRelativePathByName

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 133 of file class.ilCtrlStructure.php.

References getValueForKeyByName().

                                                             : ?string
    {
        return $this->getValueForKeyByName(self::KEY_CLASS_PATH, $class_name);
    }

Here is the call graph for this function:

getReturnTargetByClass()

ilCtrlStructure::getReturnTargetByClass

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 305 of file class.ilCtrlStructure.php.

References lowercase().

                                                              : ?string
    {
        return $this->return_targets[$this->lowercase($class_name)] ?? null;
    }

Here is the call graph for this function:

getSafeCommandsByCid()

ilCtrlStructure::getSafeCommandsByCid

(

string

$cid

)

Implements ilCtrlStructureInterface.

Definition at line 334 of file class.ilCtrlStructure.php.

References getClassNameByCid(), and getSafeCommandsByName().

                                                     : array
    {
        $class_name = $this->getClassNameByCid($cid);
        if (null !== $class_name) {
            return $this->getSafeCommandsByName($class_name);
        }

        return [];
    }

Here is the call graph for this function:

getSafeCommandsByName()

ilCtrlStructure::getSafeCommandsByName

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 347 of file class.ilCtrlStructure.php.

References lowercase().

Referenced by getSafeCommandsByCid().

                                                             : array
    {
        return $this->security[$this->lowercase($class_name)][self::KEY_SAFE_COMMANDS] ?? [];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getTemporaryParametersByClass()

ilCtrlStructure::getTemporaryParametersByClass

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 259 of file class.ilCtrlStructure.php.

References lowercase().

                                                                     : ?array
    {
        return $this->temporary_parameters[$this->lowercase($class_name)] ?? null;
    }

Here is the call graph for this function:

getUnsafeCommandsByCid()

ilCtrlStructure::getUnsafeCommandsByCid

(

string

$cid

)

Implements ilCtrlStructureInterface.

Definition at line 313 of file class.ilCtrlStructure.php.

References getClassNameByCid(), and getUnsafeCommandsByName().

                                                       : array
    {
        $class_name = $this->getClassNameByCid($cid);
        if (null !== $class_name) {
            return $this->getUnsafeCommandsByName($class_name);
        }

        return [];
    }

Here is the call graph for this function:

getUnsafeCommandsByName()

ilCtrlStructure::getUnsafeCommandsByName

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 326 of file class.ilCtrlStructure.php.

References lowercase().

Referenced by getUnsafeCommandsByCid().

                                                               : array
    {
        return $this->security[$this->lowercase($class_name)][self::KEY_UNSAFE_COMMANDS] ?? [];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getValueForKeyByCid()

ilCtrlStructure::getValueForKeyByCid ( string  $identifier_key, string  $cid  )

private

Returns a stored structure value of the given key from the corresponding class mapped by CID.

Parameters

string	$identifier_key
string	$cid

Returns

array|string|null

Definition at line 359 of file class.ilCtrlStructure.php.

Referenced by getChildrenByCid(), getClassNameByCid(), getObjNameByCid(), getParentsByCid(), and getRelativePathByCid().

    {
        if (isset($this->mapped_structure[$cid][$identifier_key])) {
            return $this->mapped_structure[$cid][$identifier_key];
        }

        foreach ($this->structure as $class_info) {
            if (isset($class_info[$identifier_key]) && $class_info[self::KEY_CLASS_CID] === $cid) {
                $this->mapped_structure[$cid] = $class_info;
                return $class_info[$identifier_key];
            }
        }

        return null;
    }

Here is the caller graph for this function:

getValueForKeyByName()

ilCtrlStructure::getValueForKeyByName ( string  $identifier_key, string  $class_name  )

private

Returns a stored structure value of the given key from the corresponding class mapped by name.

Parameters

string	$identifier_key
string	$class_name

Returns

array|string|null

Definition at line 382 of file class.ilCtrlStructure.php.

References lowercase().

Referenced by getChildrenByName(), getClassCidByName(), getObjNameByName(), getParentsByName(), and getRelativePathByName().

    {
        $class_name = $this->lowercase($class_name);
        if (isset($this->structure[$class_name])) {
            return $this->structure[$class_name][$identifier_key];
        }

        return null;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isBaseClass()

ilCtrlStructure::isBaseClass

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 84 of file class.ilCtrlStructure.php.

References getClassCidByName(), and lowercase().

                                                   : bool
    {
        // baseclass must be contained within the current structure
        // and within the current baseclass array.
        return
            null !== $this->getClassCidByName($class_name) &&
            in_array($this->lowercase($class_name), $this->base_classes, true);
    }

Here is the call graph for this function:

lowercase()

ilCtrlStructure::lowercase ( string  $string )

private

Helper function to lowercase strings.

Parameters

string

$string

Returns

string

Definition at line 397 of file class.ilCtrlStructure.php.

Referenced by getClassNameByCid(), getPermanentParametersByClass(), getReturnTargetByClass(), getSafeCommandsByName(), getTemporaryParametersByClass(), getUnsafeCommandsByName(), getValueForKeyByName(), isBaseClass(), removePermanentParametersByClass(), removeSingleParameterByClass(), removeTemporaryParametersByClass(), setPermanentParameterByClass(), setReturnTargetByClass(), and setTemporaryParameterByClass().

                                              : string
    {
        return strtolower($string);
    }

Here is the caller graph for this function:

removePermanentParametersByClass()

ilCtrlStructure::removePermanentParametersByClass

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 217 of file class.ilCtrlStructure.php.

References lowercase().

                                                                        : void
    {
        $class_name = $this->lowercase($class_name);
        if (isset($this->permanent_parameters[$class_name])) {
            unset($this->permanent_parameters[$class_name]);
        }
    }

Here is the call graph for this function:

removeSingleParameterByClass()

ilCtrlStructure::removeSingleParameterByClass	(	string	$class_name,
		string	$parameter_name
	)

Implements ilCtrlStructureInterface.

Definition at line 267 of file class.ilCtrlStructure.php.

References lowercase().

                                                                                            : void
    {
        $class_name = $this->lowercase($class_name);

        // permanent parameters are lists of parameter names
        // mapped to the classname, therefore the index is
        // unknown and has to be figured out.
        if (!empty($this->permanent_parameters[$class_name])) {
            foreach ($this->permanent_parameters[$class_name] as $index => $permanent_parameter) {
                if ($parameter_name === $permanent_parameter) {
                    unset($this->permanent_parameters[$class_name][$index]);

                    // reindex the array values.
                    $permanent_parameters = &$this->permanent_parameters[$class_name];
                    $permanent_parameters = array_values($permanent_parameters);
                }
            }
        }

        // the temporary parameters are key => value pairs mapped
        // to the classname, whereas key is the parameter name.
        // The index is therefore known and can be unset directly.
        if (isset($this->temporary_parameters[$class_name])) {
            unset($this->temporary_parameters[$class_name][$parameter_name]);
        }
    }

Here is the call graph for this function:

removeTemporaryParametersByClass()

ilCtrlStructure::removeTemporaryParametersByClass

(

string

$class_name

)

Implements ilCtrlStructureInterface.

Definition at line 248 of file class.ilCtrlStructure.php.

References lowercase().

                                                                        : void
    {
        $class_name = $this->lowercase($class_name);
        if (isset($this->temporary_parameters[$class_name])) {
            unset($this->temporary_parameters[$class_name]);
        }
    }

Here is the call graph for this function:

setPermanentParameterByClass()

ilCtrlStructure::setPermanentParameterByClass	(	string	$class_name,
		string	$parameter_name
	)

Implements ilCtrlStructureInterface.

Definition at line 201 of file class.ilCtrlStructure.php.

References lowercase(), and ilCtrlInterface\PROTECTED_PARAMETERS.

                                                                                            : void
    {
        if (in_array($parameter_name, ilCtrlInterface::PROTECTED_PARAMETERS, true)) {
            throw new ilCtrlException("Parameter '$parameter_name' must not be saved, it could mess with the control flow.");
        }

        if (!preg_match(self::PARAM_NAME_REGEX, $parameter_name)) {
            throw new ilCtrlException("Cannot save parameter '$parameter_name', as it contains invalid characters.");
        }

        $this->permanent_parameters[$this->lowercase($class_name)][] = $parameter_name;
    }

Here is the call graph for this function:

setReturnTargetByClass()

ilCtrlStructure::setReturnTargetByClass	(	string	$class_name,
		string	$target_url
	)

Implements ilCtrlStructureInterface.

Definition at line 297 of file class.ilCtrlStructure.php.

References lowercase().

                                                                                  : void
    {
        $this->return_targets[$this->lowercase($class_name)] = $target_url;
    }

Here is the call graph for this function:

setTemporaryParameterByClass()

ilCtrlStructure::setTemporaryParameterByClass	(	string	$class_name,
		string	$parameter_name,
			$value
	)

Implements ilCtrlStructureInterface.

Definition at line 236 of file class.ilCtrlStructure.php.

References lowercase().

                                                                                                    : void
    {
        if (!preg_match(self::PARAM_NAME_REGEX, $parameter_name)) {
            throw new ilCtrlException("Cannot save parameter '$parameter_name', as it contains invalid characters.");
        }

        $this->temporary_parameters[$this->lowercase($class_name)][$parameter_name] = $value;
    }

Here is the call graph for this function:

Field Documentation

$base_classes

array ilCtrlStructure::$base_classes

private

Definition at line 50 of file class.ilCtrlStructure.php.

Referenced by __construct().

$mapped_structure

array ilCtrlStructure::$mapped_structure = []

private

Definition at line 63 of file class.ilCtrlStructure.php.

$permanent_parameters

array ilCtrlStructure::$permanent_parameters = []

private

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

$return_targets

array ilCtrlStructure::$return_targets = []

private

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

$security

array ilCtrlStructure::$security

private

Definition at line 56 of file class.ilCtrlStructure.php.

$structure

array ilCtrlStructure::$structure

private

Definition at line 44 of file class.ilCtrlStructure.php.

$temporary_parameters

array ilCtrlStructure::$temporary_parameters = []

private

Definition at line 25 of file class.ilCtrlStructure.php.

PARAM_NAME_REGEX

const ilCtrlStructure::PARAM_NAME_REGEX = '/^[A-Za-z0-9_-]*$/'

private

Definition at line 18 of file class.ilCtrlStructure.php.

---

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

• components/ILIAS/UICore/classes/Structure/class.ilCtrlStructure.php