Context.php

Go to the documentation of this file.

<?php

namespace Elgg;

use Elgg\Http\Request as HttpRequest;

final class Context {
    
    private $stack = [];

    public function __construct(HttpRequest $request) {
        // don't do this for *_handler.php, etc.
        if (basename($request->server->get('SCRIPT_FILENAME') ?? '') === 'index.php') {
            $context = $request->getFirstUrlSegment();
            if (!$context) {
                $context = 'main';
            }

            $this->stack = [$context];
        }
    }

    public function peek(): ?string {
        $last = end($this->stack);
        return ($last === false) ? null : $last;
    }
    
    public function push(string $context): void {
        $this->stack[] = "$context";
    }
    
    public function pop(): ?string {
        return array_pop($this->stack);
    }
    
    public function set(string $context): bool {
        $context = trim($context);

        if (empty($context)) {
            return false;
        }

        $context = strtolower($context);

        $this->pop();
        $this->push($context);

        return true;
    }

    public function contains(string $context): bool {
        return in_array($context, $this->stack);
    }

    public function toArray(): array {
        return $this->stack;
    }

    public function fromArray(array $stack): void {
        $this->stack = array_map('strval', $stack);
    }
}