12. Middlewares en Laravel: Creación, Registro, Protección de Rutas y Filtros
Intercepta peticiones HTTP para verificar sesiones, roles de usuario (admin/student) o encabezados antes de llegar al controlador.
¿Qué es un Middleware y cómo Funciona la Capa de Cebolla?
Un Middleware actúa como un puente o filtro intermedio entre la petición que envía el usuario y el controlador que procesa la respuesta. Piensa en ellos como capas de una cebolla que envuelven tu aplicación.
Por ejemplo, Laravel incluye por defecto el middleware auth: si el usuario tiene sesión iniciada, le permite pasar hacia el controlador; si no, lo redirige de inmediato a la pantalla de /login con un mensaje de aviso.
Creando un Middleware Personalizado
Supongamos que deseas proteger las rutas de administración para que solo usuarios con rol admin puedan ingresar:
php artisan make:middleware EnsureUserIsAdmin
En el archivo generado en app/Http/Middleware/EnsureUserIsAdmin.php:
namespace App\Http\Middleware;
use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;
class EnsureUserIsAdmin
{
public function handle(Request $request, Closure $next): Response
{
// 1. Si no está autenticado o su rol no es admin, abortar con HTTP 403 Forbidden
if (!auth()->check() || auth()->user()->role !== 'admin') {
abort(403, 'Acceso denegado: Se requieren permisos de SuperAdmin.');
}
// 2. Continuar hacia la siguiente capa o controlador
return $next($request);
}
}
Registro y Aplicación a Rutas (Laravel 11/12)
En Laravel moderno, los middlewares se registran en bootstrap/app.php mediante alias simples:
// En bootstrap/app.php:
->withMiddleware(function (Middleware $middleware) {
$middleware->alias([
'admin' => \App\Http\Middleware\EnsureUserIsAdmin::class,
]);
})
Y ahora puedes aplicarlo a cualquier ruta o grupo en routes/web.php:
Route::get('/admin/panel', [AdminController::class, 'index'])->middleware(['auth', 'admin']);
⚡ Middleware de Auditoría y Verificación de Estado de Cuenta
Middleware completo que verifica si el usuario está activo y registra su última conexión.
<?php
namespace App\Http\Middleware;
use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;
class CheckUserActive
{
/**
* Intercepta la petición entrante antes de que llegue al controlador.
*/
public function handle(Request $request, Closure $next): Response
{
// 1. Verificar si hay un usuario en sesión
if (auth()->check()) {
$user = auth()->user();
// 2. Comprobar si la cuenta fue suspendida o inactivada
if (!$user->is_active) {
auth()->logout();
$request->session()->invalidate();
$request->session()->regenerateToken();
return redirect()->route('login')
->with('danger', 'Tu cuenta se encuentra suspendida. Contacta a soporte.');
}
// 3. Registrar última fecha de actividad (auditoría)
$user->updateQuietly(['last_seen_at' => now()]);
}
// 4. Pasar la petición a la siguiente capa
return $next($request);
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué función cumple la instrucción "return $next($request);" dentro del método handle() de un Middleware?
¿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.