Laravel 12 이벤트와 리스너 완벽 가이드: 이벤트 기반 아키텍처 구현과 면접 대비

<?php

namespace App\Listeners;

use App\Events\OrderShipped;

class SendOrderConfirmation
{
    public function handle(OrderShipped $event): void
    {
        // $event->order->user 에게 확인 이메일 전송
    }
}

# 이벤트 클래스 생성
php artisan make:event OrderShipped

# 이벤트에 연결된 리스너 생성
php artisan make:listener SendShipmentNotification --event=OrderShipped

<?php

namespace App\Events;

use App\Models\Order;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Queue\SerializesModels;

class OrderShipped
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    public function __construct(
        public Order $order,
    ) {}
}

<?php

namespace App\Http\Controllers;

use App\Events\OrderShipped;
use App\Models\Order;
use Illuminate\Http\Request;

class OrderController extends Controller
{
    public function ship(Request $request, Order $order)
    {
        // 배송 로직 처리...
        
        OrderShipped::dispatch($order);
        
        return redirect()->route('orders.index');
    }
}

// 추적 번호가 있는 경우에만 디스패치
OrderShipped::dispatchIf($order->tracking_number !== null, $order);

<?php

namespace App\Listeners;

use App\Events\OrderShipped;
use Illuminate\Contracts\Queue\ShouldQueue;

class SendShipmentNotification implements ShouldQueue
{
    public $queue = 'notifications';
    public $delay = 60; // 처리 전 60초 대기

    public function handle(OrderShipped $event): void
    {
        // $event->order->user 에게 알림 전송
    }
}

public function viaConnection(): string
{
    return 'redis';
}

public function viaQueue(): string
{
    return $this->event->order->priority === 'high' 
        ? 'high-priority' 
        : 'default';
}

public function shouldQueue(OrderShipped $event): bool
{
    // $100 이상의 주문만 큐에 넣기
    return $event->order->total >= 10000;
}

'connections' => [
    'redis' => [
        'after_commit' => true,
    ],
],

use Illuminate\Contracts\Queue\ShouldQueueAfterCommit;

class UpdateInventory implements ShouldQueueAfterCommit
{
    public function handle(OrderShipped $event): void
    {
        // 주문 조회 안전, 트랜잭션 커밋 완료
    }
}

use Illuminate\Contracts\Events\ShouldDispatchAfterCommit;

class OrderShipped implements ShouldDispatchAfterCommit
{
    // 트랜잭션 커밋 후에만 이벤트가 디스패치됨
}

use Illuminate\Contracts\Queue\ShouldBeUnique;
use Illuminate\Contracts\Queue\ShouldQueue;

class ProcessLicenseKey implements ShouldQueue, ShouldBeUnique
{
    public $uniqueFor = 3600; // 1시간 후 락 만료

    public function uniqueId(LicensePurchased $event): string
    {
        return 'license:' . $event->license->id;
    }

    public function handle(LicensePurchased $event): void
    {
        // 라이선스 키 생성 및 할당
    }
}

<?php

namespace App\Listeners;

use Illuminate\Auth\Events\Login;
use Illuminate\Auth\Events\Logout;
use Illuminate\Events\Dispatcher;

class UserActivitySubscriber
{
    public function handleLogin(Login $event): void
    {
        // 로그인 성공 기록, last_login 타임스탬프 업데이트
    }

    public function handleLogout(Logout $event): void
    {
        // 로그아웃 기록, 세션 데이터 정리
    }

    public function subscribe(Dispatcher $events): array
    {
        return [
            Login::class => 'handleLogin',
            Logout::class => 'handleLogout',
        ];
    }
}

public function handle(OrderShipped|OrderCancelled $event): void
{
    match (true) {
        $event instanceof OrderShipped => $this->notifyShipped($event),
        $event instanceof OrderCancelled => $this->notifyCancelled($event),
    };
}

use Illuminate\Support\Facades\Event;

Event::defer(function () {
    $user = User::create(['name' => 'John']);
    $user->posts()->create(['title' => 'Welcome']);
});
// User와 Post 생성 이벤트가 여기서 디스패치됨