KumbiaPHP/KumbiaPHP

<?php
/**
 * KumbiaPHP web & app Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.
 *
 * @category   Kumbia
 * @package    KumbiaRouter
 *
 * @copyright  Copyright (c) 2005 - 2023 KumbiaPHP Team (http://www.kumbiaphp.com)
 * @license    https://github.com/KumbiaPHP/KumbiaPHP/blob/master/LICENSE   New BSD License
 */

class KumbiaRouter
{

    /**
     * Toma $url y la descompone en (modulo), controlador, accion y argumentos
     *
     * @param string $url
     * @return  array
     */
    public static function rewrite(string $url): array
    {
        $router = [];
        //Valor por defecto
        if ($url === '/') {
            return $router;
        }

        //Se limpia la url, en caso de que la hallan escrito con el último parámetro sin valor, es decir controller/action/
        // Obtiene y asigna todos los parámetros de la url
        $urlItems = explode('/', trim($url, '/'));

        // El primer parámetro de la url es un módulo?
        if (is_dir(APP_PATH."controllers/$urlItems[0]")) {
            $router['module'] = $urlItems[0];

            // Si no hay más parámetros sale
            if (next($urlItems) === false) {
                $router['controller_path'] = "$urlItems[0]/index";
                return $router;
            }
        }

        // Controlador, cambia - por _
        $router['controller']      = str_replace('-', '_', current($urlItems));
        $router['controller_path'] = isset($router['module']) ? "$urlItems[0]/".$router['controller'] : $router['controller'];

        // Si no hay más parámetros sale
        if (next($urlItems) === false) {
            return $router;
        }

        // Acción
        $router['action'] = current($urlItems);

        // Si no hay más parámetros sale
        if (next($urlItems) === false) {
            return $router;
        }

        // Crea los parámetros y los pasa
        $router['parameters'] = array_slice($urlItems, key($urlItems));
        return $router;
    }

    /**
     * Busca en la tabla de entutamiento si hay una ruta en config/routes.ini
     * para el controlador, accion, id actual
     *
     * @param string $url Url para enrutar
     * @return string
     */
    public static function ifRouted(string $url): string
    {
        $routes = Config::get('routes.routes');

        // Si existe una ruta exacta la devuelve
        if (isset($routes[$url])) {
            return $routes[$url];
        }

        // Si existe una ruta con el comodín * crea la nueva ruta
        foreach ($routes as $key => $val) {
            if ($key === '/*') {
                return rtrim($val, '*').$url;
            }

            if (strripos($key, '*', -1)) {
                $key = rtrim($key, '*');
                if (strncmp($url, $key, strlen($key)) == 0) {
                    return str_replace($key, rtrim($val, '*'), $url);
                }
            }
        }
        return $url;
    }

    /**
     * Carga y devuelve una instancia del controllador
     * 
     * @throws KumbiaException
     * 
     * @return Controller
     */
    public static function getController(array $params): Controller
    {
        if (!include_once APP_PATH."controllers/{$params['controller_path']}_controller.php") {
            // Extrae las variables para manipularlas facilmente
            extract($params, EXTR_OVERWRITE);
            throw new KumbiaException('', 'no_controller');
        }
        //Asigna el controlador activo
        $controller = Util::camelcase($params['controller']).'Controller';
        return new $controller($params);
    }
}