CalledContexts.php

Go to the documentation of this file.

<?php namespace ILIAS\GlobalScreen\ScreenContext\Stack;

use ILIAS\GlobalScreen\ScreenContext\ScreenContext;
use LogicException;

final class CalledContexts extends ContextCollection
{

    private $call_locations = [];

    public function current() : ScreenContext
    {
        return $this->getLast();
    }

    public function push(ScreenContext $context)
    {
        $this->claim($context);
    }

    public function clear() : void
    {
        $this->call_locations = [];
        $this->stack = [];
    }

    public function claim(ScreenContext $context)
    {
        $this->checkCallLocation($context);

        if (in_array($context, $this->stack)) {
            throw new LogicException("A context can only be claimed once");
        }
        if (end($this->stack) instanceof ScreenContext) {
            $context = $context->withAdditionalData($this->getLast()->getAdditionalData());
        }

        parent::push($context);
    }

    private function checkCallLocation(ScreenContext $context)
    {
        $called_classes = array_filter(
            debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS),
            function ($item) {
                if (!isset($item['class'])) {
                    return false;
                }

                return (!in_array($item['class'], [CalledContexts::class, ContextCollection::class]));
            }
        );
        array_walk(
            $called_classes,
            function (&$item) {
                $item = $item['class'] . ":" . $item['line'];
            }
        );

        $call_location = reset($called_classes);

        if (isset($this->call_locations[$context->getUniqueContextIdentifier()])) {
            $first_location = $this->call_locations[$context->getUniqueContextIdentifier()];
            throw new LogicException("context '{$context->getUniqueContextIdentifier()}' already claimed in $first_location, second try in $call_location");
        }
        $this->call_locations[$context->getUniqueContextIdentifier()] = $call_location;
    }
}