Tema 6 · Enrutamiento REST

6. Sistema de Enrutamiento REST Nativo con REQUEST_METHOD y REQUEST_URI

Construye un enrutador ligero en PHP puro que despache peticiones analizando el método HTTP, la URL y capture parámetros dinámicos numéricos (IDs).

El Enrutador (Router): El Cerebro de la API

En una API REST no creamos un archivo .php por cada recurso (como listar.php, crear.php, editar.php). Todas las peticiones HTTP ingresan a un único punto de entrada: public/index.php mediante reescritura de URLs en Nginx o Apache.

El enrutador tiene la misión de inspeccionar:

  • El método HTTP: $_SERVER['REQUEST_METHOD'] (GET, POST, PUT, DELETE).
  • La ruta de la URI: $_SERVER['REQUEST_URI'] (ej: /api/v1/productos/42).

Captura de Parámetros Dinámicos con Expresiones Regulares

Rutas como /api/productos/15 contienen un parámetro variable (el ID 15). En PHP nativo podemos comparar la ruta con preg_match para extraer estos identificadores de forma segura:

if (preg_match('#^/api/productos/([0-9]+)$#', $ruta, $matches)) {
    $productoId = (int)$matches[1];
    // Ejecutar lógica para el producto con ID capturado
}

⚡ Micro-Enrutador RESTful Completo en PHP Puro

Implementación funcional de un despachador de rutas que maneja verbos y parámetros numéricos:

Router.php
Solo lectura
<?php
declare(strict_types=1);

final class Router
{
    private array $rutas = [];

    public function agregar(string $metodo, string $patron, callable $controlador): void
    {
        $this->rutas[] = [
            'metodo'      => strtoupper($metodo),
            'patron'      => $patron,
            'controlador' => $controlador,
        ];
    }

    public function despachar(string $metodoPeticion, string $uriPeticion): void
    {
        // Limpiar parámetros de query string (ej: ?pagina=2)
        $rutaLimpia = parse_url($uriPeticion, PHP_URL_PATH) ?? '/';

        foreach ($this->rutas as $ruta) {
            if ($ruta['metodo'] !== $metodoPeticion) {
                continue;
            }

            // Convertir /api/productos/{id} en expresión regular
            $regex = preg_replace('#\{([a-zA-Z0-9_]+)\}#', '([0-9]+)', $ruta['patron']);
            $regex = '#^' . $regex . '$#';

            if (preg_match($regex, $rutaLimpia, $coincidencias)) {
                array_shift($coincidencias); // Quitar coincidencia completa
                call_user_func_array($ruta['controlador'], $coincidencias);
                return;
            }
        }

        // Si ninguna ruta coincidió
        http_response_code(404);
        header('Content-Type: application/json');
        echo json_encode(['error' => 'Endpoint no encontrado', 'ruta' => $rutaLimpia]);
    }
}

// Ejemplo de registro de rutas:
// $router = new Router();
// $router->agregar('GET', '/api/productos', function() { echo 'Lista productos'; });
// $router->agregar('GET', '/api/productos/{id}', function($id) { echo "Producto ID: $id"; });
// $router->despachar($_SERVER['REQUEST_METHOD'], $_SERVER['REQUEST_URI']);
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué se debe utilizar parse_url($uri, PHP_URL_PATH) antes de comparar la ruta en el Router?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar APIs RESTful con PHP Puro, JSON & JWT y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.