Router.php

Go to the documentation of this file.

<?php
namespace Elgg;

use Elgg\Http\Request;

class Router {
    use Profilable;

    private $handlers = array();
    private $hooks;

    public function __construct(\Elgg\PluginHooksService $hooks) {
        $this->hooks = $hooks;
    }

    public function route(\Elgg\Http\Request $request) {
        $segments = $request->getUrlSegments();
        if ($segments) {
            $identifier = array_shift($segments);
        } else {
            $identifier = '';

            // this plugin hook is deprecated. Use elgg_register_page_handler()
            // to register for the '' (empty string) handler.
            // allow plugins to override the front page (return true to indicate
            // that the front page has been served)
            $result = _elgg_services()->hooks->trigger('index', 'system', null, false);
            if ($result === true) {
                elgg_deprecated_notice("The 'index', 'system' plugin has been deprecated. See elgg_front_page_handler()", 1.9);
                exit;
            }
        }

        // return false to stop processing the request (because you handled it)
        // return a new $result array if you want to route the request differently
        $old = array(
            'identifier' => $identifier,
            'handler' => $identifier, // backward compatibility
            'segments' => $segments,
        );

        if ($this->timer) {
            $this->timer->begin(['build page']);
        }

        $result = $this->hooks->trigger('route', $identifier, $old, $old);
        if ($result === false) {
            return true;
        }

        if ($result !== $old) {
            _elgg_services()->logger->warn('Use the route:rewrite hook to modify routes.');
        }

        if ($identifier != $result['identifier']) {
            $identifier = $result['identifier'];
        } else if ($identifier != $result['handler']) {
            $identifier = $result['handler'];
        }

        $segments = $result['segments'];

        $handled = false;
        ob_start();

        if (isset($this->handlers[$identifier]) && is_callable($this->handlers[$identifier])) {
            $function = $this->handlers[$identifier];
            $handled = call_user_func($function, $segments, $identifier);
        }

        $output = ob_get_clean();

        $ajax_api = _elgg_services()->ajax;
        if ($ajax_api->isReady()) {
            $path = implode('/', $request->getUrlSegments());
            $ajax_api->respondFromOutput($output, "path:$path");
            return true;
        }

        echo $output;
        return $handled || headers_sent();
    }

    public function registerPageHandler($identifier, $function) {
        if (is_callable($function, true)) {
            $this->handlers[$identifier] = $function;
            return true;
        }

        return false;
    }

    public function unregisterPageHandler($identifier) {
        unset($this->handlers[$identifier]);
    }

    public function getPageHandlers() {
        return $this->handlers;
    }

    public function allowRewrite(Request $request) {
        $segments = $request->getUrlSegments();
        if ($segments) {
            $identifier = array_shift($segments);
        } else {
            $identifier = '';
        }

        $old = array(
            'identifier' => $identifier,
            'segments' => $segments,
        );
        $new = _elgg_services()->hooks->trigger('route:rewrite', $identifier, $old, $old);
        if ($new === $old) {
            return $request;
        }

        if (!isset($new['identifier'])
            || !isset($new['segments'])
            || !is_string($new['identifier'])
            || !is_array($new['segments'])
        ) {
            throw new \RuntimeException('rewrite_path handler returned invalid route data.');
        }

        // rewrite request
        $segments = $new['segments'];
        array_unshift($segments, $new['identifier']);
        return $request->setUrlSegments($segments);
    }
}