Middleware Global en Laravel

Concepto

En esta lección, aprenderemos sobre el middleware global en Laravel. Un middleware es una capa de código que se ejecuta entre la solicitud del cliente y la respuesta del servidor. Permite realizar tareas como la autenticación, la validación de datos y el registro de actividades. El middleware global se ejecuta en cada solicitud HTTP que recibe tu aplicación, lo que significa que cualquier lógica que coloques en un middleware global se aplicará a todas las rutas de tu aplicación.

Donde Escribir el Código

El código debe escribirse en bootstrap/app.php. Este archivo es crucial para la configuración de la aplicación Laravel y es donde se pueden registrar middlewares globales. Asegúrate de que el middleware que deseas agregar esté correctamente importado y configurado en este archivo.

Ejemplos de Código

use App\Http\Middleware\EnsureTokenIsValid;

// ... código existente ...

->withMiddleware(function (Middleware $middleware) {
    $middleware->append(EnsureTokenIsValid::class);
});

Explicación del Código

En el ejemplo anterior, estamos utilizando el middleware EnsureTokenIsValid. Este middleware se encargará de verificar la validez de un token en cada solicitud que se realice a la aplicación. A continuación, desglosamos cada parte del código:

• use App\Http\Middleware\EnsureTokenIsValid;: Esta línea importa la clase EnsureTokenIsValid desde el espacio de nombres App\Http\Middleware. Esto significa que estamos utilizando un middleware que ya ha sido definido en nuestra aplicación, el cual se encargará de validar un token de autenticación. Este middleware es esencial para proteger las rutas que requieren autenticación, asegurando que solo los usuarios con un token válido puedan acceder a ellas.
• ->withMiddleware(function (Middleware $middleware) { … });: Aquí estamos utilizando un método llamado withMiddleware. Este método permite agregar middleware a la pila de middleware de la aplicación. La función que se pasa como argumento recibe un objeto $middleware, que es una instancia de Illuminate\Foundation\Configuration\Middleware. Este objeto es responsable de gestionar todos los middlewares que se asignan a las rutas de la aplicación. Esto significa que puedes agregar, eliminar o modificar middlewares según sea necesario.
• $middleware->append(EnsureTokenIsValid::class);: Este método append agrega el middleware EnsureTokenIsValid al final de la lista de middlewares globales. Esto significa que se ejecutará después de cualquier otro middleware que ya esté en la lista. Al usar append, garantizamos que la lógica de validación del token se ejecute en el orden correcto, permitiendo que otros middlewares se procesen primero si es necesario. Si deseas que se ejecute antes de otros middlewares, puedes utilizar el método prepend, que colocará el middleware al principio de la lista.

Visualización Gráfica en Pantalla

Cuando se ejecuta una solicitud HTTP, por ejemplo, al acceder a una URL como http://www.conozcalaravel.test, el middleware se ejecutará automáticamente. En la consola de Visual Studio Code, podrías ver algo como esto:

GET http://www.conozcalaravel.test/api/resource
Status: 200 OK

Esto indica que la solicitud se ha procesado correctamente y que el middleware ha validado el token antes de permitir el acceso al recurso solicitado. Si el token no es válido, el middleware puede devolver un error, como un código de estado 401 (Unauthorized), lo que significa que el acceso ha sido denegado.

Conclusión

En resumen, el middleware global es una herramienta poderosa en Laravel que permite ejecutar lógica en cada solicitud. Puedes añadir middlewares utilizando los métodos append y prepend para gestionar su orden de ejecución, asegurando que las validaciones necesarias se realicen en el momento adecuado. Esto es esencial para mantener la seguridad y la integridad de tu aplicación.

Enlaces

Para más información, visita la página oficial de Laravel: Laravel Middleware Documentation.

También puedes ver Laravel en español en: Conozca Laravel.