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:
<?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¿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.