Événements & Listeners : L'Architecture Découplée

// 1. Générer l'événement et le listener en terminal :
// php artisan make:event OrderPlaced
// php artisan make:listener SendOrderConfirmation --event=OrderPlaced

// 2. app/Events/OrderPlaced.php (Événement typé en PHP 8.2)
namespace AppEvents;

use AppModelsOrder;
use IlluminateFoundationEventsDispatchable;
use IlluminateQueueSerializesModels;

class OrderPlaced
{
    use Dispatchable, SerializesModels;

    // Promotion de propriété en constructeur PHP 8
    public function __construct(public Order $order) {}
}

// 3. app/Listeners/SendOrderConfirmation.php (Listener Asynchrone)
namespace AppListeners;

use AppEventsOrderPlaced;
use IlluminateContractsQueueShouldQueue;
use IlluminateSupportFacadesMail;

class SendOrderConfirmation implements ShouldQueue
{
    public function handle(OrderPlaced $event): void
    {
        // Accès direct à l'objet commande injecté dans l'événement
        Mail::to($event->order->customer_email)->send(new OrderReceiptMail($event->order));
    }
}

// 4. Dans le contrôleur : Déclenchement élégant en une seule ligne !
OrderPlaced::dispatch($order);