class.ilCtrlStructureMapper.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
class ilCtrlStructureMapper
{
    private array $ctrl_structure;
 
    public function __construct(array $ctrl_structure)
    {
        $this->ctrl_structure = $ctrl_structure;
        $this->mapStructure();
    }
 
    public function getStructure(): array
    {
        return $this->ctrl_structure;
    }
 
    private function addViseVersaMappingByClass(string $class_name, string $key_ref_from, string $key_ref_to): void
    {
        if (!empty($this->ctrl_structure[$class_name][$key_ref_from])) {
            $invalid_indices = [];
 
            foreach ($this->ctrl_structure[$class_name][$key_ref_from] as $index => $reference) {
                $is_reference_available = isset($this->ctrl_structure[$reference]);
                $is_reference_valid = $this->isStructureEntryValid($reference);
 
                // the vise-versa mapping must only be processed if the
                // reference is available and a valid structure entry.
                if ($is_reference_available && $is_reference_valid) {
                    // create reference list if not yet initialized.
                    if (!isset($this->ctrl_structure[$reference][$key_ref_to])) {
                        $this->ctrl_structure[$reference][$key_ref_to] = [];
                    }
 
                    // only add vise-versa mapping if it doesn't already exist.
                    if (!in_array($class_name, $this->ctrl_structure[$reference][$key_ref_to], true)) {
                        $this->ctrl_structure[$reference][$key_ref_to][] = $class_name;
                    }
                }
 
                // if the referenced class does not exist within the current
                // structure, the reference is removed from the reference list.
                if (!$is_reference_available || !$is_reference_valid) {
                    $invalid_indices[] = $index;
                }
            }
 
            $this->removeInvalidReferences($invalid_indices, $class_name, $key_ref_from);
        }
    }
 
    private function mapStructure(): void
    {
        if (!empty($this->ctrl_structure)) {
            foreach ($this->ctrl_structure as $class_name => $data) {
                if ($this->isStructureEntryValid($class_name)) {
                    $this->addViseVersaMappingByClass(
                        $class_name,
                        ilCtrlStructureInterface::KEY_CLASS_CHILDREN,
                        ilCtrlStructureInterface::KEY_CLASS_PARENTS,
                    );
 
                    $this->addViseVersaMappingByClass(
                        $class_name,
                        ilCtrlStructureInterface::KEY_CLASS_PARENTS,
                        ilCtrlStructureInterface::KEY_CLASS_CHILDREN,
                    );
                } else {
                    // remove/unset invalid structure entries.
                    unset($this->ctrl_structure[$class_name]);
                }
            }
        }
    }
 
    private function removeInvalidReferences(array $invalid_indices, string $class_name, string $key_ref_from): void
    {
        foreach ($invalid_indices as $index) {
            unset($this->ctrl_structure[$class_name][$key_ref_from][$index]);
        }
 
        // Re-index the array once after all removals
        if (!empty($invalid_indices)) {
            $this->ctrl_structure[$class_name][$key_ref_from] = array_values(
                $this->ctrl_structure[$class_name][$key_ref_from]
            );
        }
    }
 
    private function isStructureEntryValid($index): bool
    {
        // structure entry is not a classname.
        if (!is_string($index)) {
            return false;
        }
 
        // index is not contained in the structure.
        if (!isset($this->ctrl_structure[$index])) {
            return false;
        }
 
        // structure value is not an array
        if (!is_array($this->ctrl_structure[$index])) {
            return false;
        }
 
        return true;
    }
}