Router.php

<?php
/**
 * This code is licensed under AGPLv3 license or Afterlogic Software License
 * if commercial version of the product was purchased.
 * For full statements of the licenses see LICENSE-AFTERLOGIC and LICENSE-AGPL3 files.
 */

namespace Aurora\System;

/**
 * @license https://www.gnu.org/licenses/agpl-3.0.html AGPL-3.0
 * @license https://afterlogic.com/products/common-licensing Afterlogic Software License
 * @copyright Copyright (c) 2019, Afterlogic Corp.
 *
 * @package Api
 */
class Router
{
    /**
     * @var array
     */
    protected $aRoutes;

    protected static $self = null;

    public function __construct()
    {
        $this->aRoutes = [];
    }

    /**
     * @return \Aurora\System\Router
     */
    public static function getInstance()
    {
        if (is_null(self::$self)) {
            self::$self = new self();
        }

        return self::$self;
    }

    public function register($sModule, $sName, $mCallbak)
    {
        if (!isset($this->aRoutes[$sName][$sModule])) {
            $this->aRoutes[$sName][$sModule] = $mCallbak;
        }
    }

    public function registerArray($sModule, $aRoutes)
    {
        foreach ($aRoutes as $sName => $mCallbak) {
            $this->register($sModule, $sName, $mCallbak);
        }
    }

    /**
     *
     * @param string $sName
     * @return mixed
     */
    public function getCallback($sName)
    {
        $mResult = false;
        if (isset($this->aRoutes[$sName])) {
            $mResult = $this->aRoutes[$sName];
        }

        return $mResult;
    }

    public function hasCallback($mCallbak)
    {
        $aCallbacks = [];
        foreach ($this->aRoutes as $sRoute => $aRoutes) {
            foreach ($aRoutes as $sModule => $aRoute) {
                if (!in_array($aRoute[1], $aCallbacks)) {
                    $aCallbacks[] = $aRoute[1];
                }
            }
        }

        return in_array($mCallbak, $aCallbacks);
    }

    public function hasRoute($sName)
    {
        return isset($this->aRoutes[$sName]);
    }

    public function route($sName)
    {
        $mResult = [];
        $oHttp = \MailSo\Base\Http::SingletonInstance();

        $mMethod = $this->getCallback($sName);
        if ($mMethod) {
            foreach ($mMethod as $sModule => $mCallbak) {
                if (\Aurora\System\Api::GetModuleManager()->IsAllowedModule($sModule)) {
                    \Aurora\System\Api::Log(" ");
                    \Aurora\System\Api::Log(" ===== ENTRY: " . $sModule . '::' . $sName);
                    \Aurora\System\Api::Log(" URL: " . $oHttp->GetUrl());
                    $mResult[] = call_user_func_array(
                        $mCallbak,
                        []
                    );
                }
            }
        }

        // This is an unsupported case. Work with multiple callbacks of one an entry point was kept for backward compatibility.
        if (count($mResult) > 1) {
            \Aurora\System\Api::Log(" WARNING: More than one entry result returned");
        }

        return $mResult[0] ?? false;
    }

    public function removeRoute($sName)
    {
        unset($this->aRoutes[$sName]);
    }

    /**
     * @return array
     */
    public static function getItems()
    {
        static $aResult = null;
        if ($aResult === null) {
            $aResult = array();

            $oHttp = \MailSo\Base\Http::SingletonInstance();

            $sQuery = \trim(\trim(urldecode($oHttp->GetQueryString())), ' /');

            $iPos = \strpos($sQuery, '&');
            if (0 < $iPos) {
                $sQuery = \substr($sQuery, 0, $iPos);
            }
            $aQuery = \explode('/', $sQuery);
            foreach ($aQuery as $sQueryItem) {
                $iPos = \strpos($sQueryItem, '=');
                $aResult[] = (!$iPos) ? $sQueryItem : \substr($sQueryItem, 0, $iPos);
            }
        }

        return $aResult;
    }

    /**
     *
     * @param int $iIndex
     */
    public static function getItemByIndex($iIndex, $mDefaultValue = null)
    {
        $aPath = self::getItems();

        return !empty($aPath[$iIndex]) ? $aPath[$iIndex] : $mDefaultValue;
    }
}