Tema 12 · Middlewares

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.

CheckUserActive.php
Solo lectura
<?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
1 Pregunta
Pregunta 1
¿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.

🏛️ 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.