Tema 4 · Enrutamiento

4. Sistema de Rutas (web.php y api.php), Parámetros, Nombres y Grupos

Define rutas con verbos HTTP, captura parámetros obligatorios u opcionales, asigna nombres y agrupa rutas con prefijos y middlewares.

El Enrutador de Laravel: Expresividad y Potencia

En Laravel, todas las rutas de la aplicación se definen de forma centralizada en el directorio routes/:

  • routes/web.php: Rutas para usuarios humanos en navegadores web. Incluyen automáticamente el grupo de middlewares web (sesión con cookies, protección CSRF y encripción).
  • routes/api.php: Rutas para APIs y servicios móviles. Incluyen el grupo api (sin sesiones con estado, sin cookies, optimizadas para tokens y limitación de tasa rate limiting).

La fachada Route proporciona métodos para todos los verbos HTTP estándar del protocolo:

use Illuminate\Support\Facades\Route;

Route::get('/contacto', [ContactoController::class, 'show']);
Route::post('/contacto', [ContactoController::class, 'enviar']);
Route::put('/perfil/{id}', [PerfilController::class, 'update']);
Route::delete('/cursos/{id}', [CursoController::class, 'destroy']);

Parámetros en Rutas y Rutas con Nombre

Puedes capturar segmentos dinámicos de la URL encerrándolos entre llaves {parametro}:

  • Parámetro Obligatorio: Route::get('/cursos/{id}', ...).
  • Parámetro Opcional: Route::get('/catalogo/{categoria?}', ...) (requiere valor por defecto en la función).
  • Validación con Expresiones Regulares: ->whereNumber('id') o ->whereAlpha('categoria').

Rutas con Nombre: Siempre debes nombrar tus rutas con ->name('nombre.ruta'). Esto te permite cambiar la URL en cualquier momento sin romper los enlaces en tus vistas ni redirecciones en controladores:

// En routes/web.php:
Route::get('/cursos/{slug}', [CursoController::class, 'show'])->name('cursos.show');

// En Blade o Controladores:
// Generar URL: route('cursos.show', ['slug' => 'desarrollo-web'])
// Redirección: return redirect()->route('cursos.show', ['slug' => 'desarrollo-web']);

Grupos de Rutas: Prefijos y Middlewares

Cuando varias rutas comparten un prefijo en la URL o requieren la misma seguridad (por ejemplo, el panel de administración), se agrupan para evitar repetición de código:

Route::middleware(['auth', 'admin'])->prefix('admin')->name('admin.')->group(function () {
    Route::get('/dashboard', [AdminController::class, 'index'])->name('dashboard');
    Route::get('/usuarios', [AdminController::class, 'usuarios'])->name('usuarios');
});
// Genera: /admin/dashboard (admin.dashboard) y /admin/usuarios (admin.usuarios) protegidas

⚡ Archivo routes/web.php con Parámetros, Grupos y Nombres

Ejemplo completo de definición de rutas organizadas en Laravel 11/12.

routes-web-example.php
Solo lectura
<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\HomeController;
use App\Http\Controllers\CursoController;
use App\Http\Controllers\Admin\DashboardController;

// 1. Ruta de Inicio
Route::get('/', [HomeController::class, 'index'])->name('home');

// 2. Ruta con parámetro obligatorio y validación numérica
Route::get('/cursos/{id}', [CursoController::class, 'show'])
    ->whereNumber('id')
    ->name('cursos.show');

// 3. Ruta con parámetro tipo texto (slug amigable)
Route::get('/manuales/{tech}/{slug}', [CursoController::class, 'manual'])
    ->whereAlpha('tech')
    ->name('manuales.topic');

// 4. Grupo de Rutas Privadas para Alumnos Autenticados
Route::middleware(['auth'])->prefix('cuenta')->name('cuenta.')->group(function () {
    Route::get('/', [HomeController::class, 'perfil'])->name('perfil');
    Route::get('/mis-cursos', [CursoController::class, 'misCursos'])->name('cursos');
});

// 5. Listar todas las rutas registradas desde la terminal:
// php artisan route:list
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es la principal ventaja de utilizar rutas con nombre (->name("cursos.show")) en Laravel?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Laravel Framework Profesional 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.