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 middlewaresweb(sesión con cookies, protección CSRF y encripción).routes/api.php: Rutas para APIs y servicios móviles. Incluyen el grupoapi(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.
<?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¿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.