Eventos en Laravel: Guía para Desarrolladores

Laravel es un framework de PHP conocido por su elegancia y facilidad de uso. Una de sus características más poderosas es su sistema de eventos, que permite a los desarrolladores ejecutar acciones en respuesta a ciertos cambios dentro de la aplicación.

¿Qué es el sistema de eventos en Laravel?

El sistema de eventos permite desacoplar partes de una aplicación mediante la ejecución de eventos y la escucha de estos con listeners (escuchadores). Un evento es una acción o cambio en la aplicación, mientras que un listener es una clase que ejecuta lógica específica cuando ese evento ocurre.

Configuración inicial en Laravel

Antes de empezar, asegúrate de tener un proyecto Laravel funcionando. Si no lo tienes, puedes crear uno siguiendo la guía oficial de instalación de Laravel:

composer create-project --prefer-dist laravel/laravel MiProyecto

Luego, ingresa al directorio del proyecto:

cd MiProyecto

Ejecuta las migraciones para generar la estructura de base de datos inicial:

php artisan migrate

Creación de un evento en Laravel

Laravel nos proporciona el comando make:event para crear eventos. Supongamos que estamos construyendo un sistema de pedidos y queremos lanzar uno cuando se cree un pedido:

php artisan make:event PedidoCreado

Esto generará un archivo en app/Events/PedidoCreado.php con el siguiente código base:

namespace App\Events;

use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;
use App\Models\Pedido;

class PedidoCreado
{
    use Dispatchable, SerializesModels;

    public $pedido;

    public function __construct(Pedido $pedido)
    {
        $this->pedido = $pedido;
    }
}

Creación de un Listener para capturar el evento

Ahora, creamos un listener que responderá a este evento:

php artisan make:listener EnviarNotificacionPedido --event=PedidoCreado

Este comando generará un archivo en app/Listeners/EnviarNotificacionPedido.php:

namespace App\Listeners;

use App\Events\PedidoCreado;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Queue\InteractsWithQueue;
use Mail;
use App\Mail\PedidoConfirmado;

class EnviarNotificacionPedido implements ShouldQueue
{
    use InteractsWithQueue;

    public function handle(PedidoCreado $event)
    {
        Mail::to($event->pedido->usuario->email)->send(new PedidoConfirmado($event->pedido));
    }
}

Registrar los eventos y listeners en Laravel

En app/Providers/EventServiceProvider.php, registramos el evento con su listener dentro de la propiedad $listen:

protected $listen = [
    PedidoCreado::class => [
        EnviarNotificacionPedido::class,
    ],
];

Para que Laravel detecte los cambios, ejecutamos:

php artisan event:clear
php artisan event:cache

(Más detalles sobre cómo trabajar con el Event Service Provider).

Lanzar el evento desde un controlador

En app/Http/Controllers/PedidoController.php, disparamos el evento cuando se crea un pedido:

namespace App\Http\Controllers;

use App\Models\Pedido;
use App\Events\PedidoCreado;
use Illuminate\Http\Request;

class PedidoController extends Controller
{
    public function store(Request $request)
    {
        $pedido = Pedido::create([
            'usuario_id' => auth()->id(),
            'total' => $request->total,
            'estado' => 'pendiente'
        ]);

        event(new PedidoCreado($pedido));

        return response()->json(['message' => 'Pedido creado y evento disparado.']);
    }
}

Probando el sistema de eventos

Para probar si todo funciona correctamente, podemos hacer una solicitud POST al endpoint:

curl -X POST http://localhost/api/pedidos \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer TU_TOKEN" \
     -d '{"total": 100.50}'

Conclusión

El sistema de eventos de Laravel es una herramienta increíblemente útil para desacoplar la lógica de negocio y responder de manera eficiente a los cambios en la aplicación. En este tutorial, aprendimos a:

• Crear eventos y listeners.
• Registrar y despachar eventos.
• Ejecutar eventos en segundo plano con colas.

Este enfoque mejora la estructura de nuestras aplicaciones, haciéndolas más mantenibles y escalables.