Laravel의 이벤트 시스템은 분리되고 완전히 복잡한 앱을 구축하기 위한 초석이기 때문에 웹 앱의 복잡한 데이터를 처리할 때 경이롭습니다. 이 가이드는 특히 2024년 이벤트 리스닝의 구현 및 활용에 대한 매우 자세한 사항을 설명하며 Laravel 11의 가장 광범위한 콘텐츠와 자세한 코드 예제 이벤트 리스너를 통해 새로운 관점을 제공합니다.

*(A) 이벤트 및 청취자의 핵심 이해
*
이제 분석해 보겠습니다. Laravel의 이벤트는 앱 내에서 특정 발생을 나타냅니다. 리스너는 이러한 모든 앱 이벤트에 응답하는 클래스입니다. 이 패턴은 계속해서 우려 사항의 분리를 촉진하고 보다 모듈화되고 테스트 가능한 코드를 허용해 왔습니다.

*(B) 이벤트 만들기
*
더 잘 설명하기 위해 Artisan 명령을 사용할 복잡한 이벤트를 만드는 것부터 시작하겠습니다. 여러분도 그렇게 하시기를 적극 권장합니다

php artisan make:event 주문 완료

이 명령은 app/Events 디렉토리에 새 이벤트 클래스를 생성합니다. 좀 더 자세한 이벤트 클래스를 살펴보겠습니다.

`네임스페이스 앱\이벤트;

App\Models\Order 사용;
앱\모델\사용자 사용;
Illuminate\Foundation\Events\Dispatchable;
를 사용하세요. Illuminate\Queue\SerializesModels;
를 사용하세요. Illuminate\Broadcasting\InteractsWithSockets;
를 사용하세요. Illuminate\Broadcasting\PrivateChannel;
를 사용하세요. Illuminate\Contracts\Broadcasting\ShouldBroadcast;

OrderPlaced 클래스는 ShouldBroadcast를 구현합니다.
{
Dispatchable, InteractsWithSockets, SerializesModels 사용;

public $order;
public $user;

/**
 * Create a new event instance.
 *
 * @param  \App\Models\Order  $order
 * @param  \App\Models\User  $user
 * @return void
 */
public function __construct(Order $order, User $user)
{
    $this->order = $order;
    $this->user = $user;
}

/**
 * Get the channels the event should broadcast on.
 *
 * @return \Illuminate\Broadcasting\Channel|array
 */
public function broadcastOn()
{
    return new PrivateChannel('orders.'.$this->user->id);
}

/**
 * The event's broadcast name.
 *
 * @return string
 */
public function broadcastAs()
{
    return 'order.placed';
}

}`

이 확장된 예에서는 Order 및 User 모델을 모두 포함했습니다. SerializesModels 특성은 이벤트가 대기 중인 리스너에게 전달될 때 Eloquent 모델이 올바르게 직렬화 및 역직렬화되도록 보장해 왔습니다. 또한 ShouldBroadcast 인터페이스를 구현하고 broadcastOn 및 broadcastAs 메소드를 정의하여 이 이벤트가 실시간 업데이트를 위해 웹소켓에 브로드캐스팅될 수 있도록 했습니다.

*여러 리스너 생성
*
단일 이벤트의 경우 여러 리스너가 필요할 수 있습니다. 예제를 더 확장하기 위해 OrderPlaced 이벤트에 대한 두 개의 리스너를 생성해 보겠습니다. 나는 단지 여러분이 모든 것의 요점을 확실히 이해하기를 바랍니다. 이에 대해서는 아래 코드 예시를 참조하세요.

php artisan make:listener SendOrderConfirmation --event=OrderPlaced
php artisan make:listener UpdateInventory --event=OrderPlaced

이제 이 명령줄을 사용하면 app/Listeners 디렉터리에 몇 가지 새로운 리스너 클래스가 생성된다는 점을 이해하셨을 것입니다. 이제 문제는 아래에서 SendOrderConfirmation 리스너를 검사하고 어떻게 진행되는지 살펴보겠습니다.

`네임스페이스 앱\리스너;

App\Events\OrderPlaced 사용;
App\Mail\OrderConfirmation;
사용 Illuminate\Contracts\Queue\ShouldQueue;
를 사용하세요. Illuminate\Queue\InteractsWithQueue;
를 사용하세요. Illuminate\Support\Facades\Mail을 사용합니다.
Illuminate\Support\Facades\Log;

클래스 SendOrderConfirmation은 ShouldQueue를 구현합니다.
{
InteractsWithQueue;

/**
 * The number of times the job may be attempted.
 *
 * @var int
 */
public $tries = 3;

/**
 * Handle the event.
 *
 * @param  \App\Events\OrderPlaced  $event
 * @return void
 */
public function handle(OrderPlaced $event)
{
    $order = $event->order;
    $user = $event->user;

    try {
        Mail::to($user->email)->send(new OrderConfirmation($order));
        Log::info('Order confirmation email sent', ['order_id' => $order->id, 'user_id' => $user->id]);
    } catch (\Exception $e) {
        Log::error('Failed to send order confirmation email', ['order_id' => $order->id, 'user_id' => $user->id, 'error' => $e->getMessage()]);
        $this->fail($e);
    }
}

/**
 * Handle a job failure.
 *
 * @param  \App\Events\OrderPlaced  $event
 * @param  \Throwable  $exception
 * @return void
 */
public function failed(OrderPlaced $event, $exception)
{
    Log::error('Order confirmation listener failed', ['order_id' => $event->order->id, 'user_id' => $event->user->id, 'error' => $exception->getMessage()]);
}

}`

이 리스너는 대기열에 있어야 함을 나타내는 ShouldQueue 인터페이스를 구현했습니다. 오류 처리, 로깅을 추가하고 실패를 처리하기 위한 실패한 메서드를 정의했습니다. $tries 속성은 실패 시 여러 번의 시도를 허용하도록 설정됩니다.
이제 UpdateInventory 리스너

`네임스페이스 앱\리스너;

App\Events\OrderPlaced 사용;
Illuminate\Contracts\Queue\ShouldQueue;
를 사용하세요. Illuminate\Queue\InteractsWithQueue;
를 사용하세요. Illuminate\Support\Facades\DB;
를 사용하십시오. Illuminate\Support\Facades\Log;

클래스 UpdateInventory는 ShouldQueue를 구현합니다.
{
InteractsWithQueue;

/**
 * Handle the event.
 *
 * @param  \App\Events\OrderPlaced  $event
 * @return void
 */
public function handle(OrderPlaced $event)
{
    $order = $event->order;

    DB::transaction(function () use ($order) {
        foreach ($order->items as $item) {
            $product = $item->product;

            if ($product->stock quantity) {
                throw new \Exception("Insufficient stock for product: {$product->id}");
            }

            $product->decrement('stock', $item->quantity);
            Log::info("Inventory updated", ['product_id' => $product->id, 'quantity' => $item->quantity]);
        }
    });
}

/**
 * Handle a job failure.
 *
 * @param  \App\Events\OrderPlaced  $event
 * @param  \Throwable  $exception
 * @return void
 */
public function failed(OrderPlaced $event, $exception)
{
    Log::error('Failed to update inventory', ['order_id' => $event->order->id, 'error' => $exception->getMessage()]);
}

}`

이제 이 리스너는 주문 항목 등을 기반으로 재고를 업그레이드하는 것과 같은 이유로 존재한다는 것을 이해하실 것입니다. 데이터 일관성을 보장하기 위해 데이터베이스 트랜잭션에 재고 업데이트를 래핑했습니다. 또한 재고 감소를 방지하기 위해 오류 검사를 추가하고 성공적인 업데이트 및 실패에 대한 로깅을 포함했습니다.

*이벤트 및 리스너 등록
*
EventServiceProvider

`App\Events\OrderPlaced 사용;
App\Listeners\SendOrderConfirmation;
사용 App\Listeners\UpdateInventory;

클래스 EventServiceProvider는 ServiceProvider를 확장합니다.
{
/**
* 애플리케이션에 대한 이벤트 리스너 매핑입니다.
*
* @var 배열
*/
보호된 $listen = [
OrderPlaced::class => [
SendOrderConfirmation::class,
업데이트인벤토리::class,
],
];

/**
 * Register any events for your application.
 *
 * @return void
 */
public function boot()
{
    parent::boot();

    //
}

}`

이벤트 전달:

컨트롤러나 서비스 클래스에서 이벤트를 전달할 수 있습니다.

`App\Events\OrderPlaced 사용;
앱\모델\주문;
사용 Illuminate\Http\Request;
를 사용하세요. Illuminate\Support\Facades\DB;

클래스 OrderController는 컨트롤러를 확장합니다.
{
/**
* 새로 주문하세요.
*
* @param \Illuminate\Http\Request $request
* @return \Illuminate\Http\JsonResponse
*/
공개 함수 placeOrder($request 요청)
{
$user = 인증()->사용자();

    DB::transaction(function () use ($request, $user) {
        $order = Order::create($request->all());
        $order->user()->associate($user);
        $order->save();

        event(new OrderPlaced($order, $user));
    });

    return response()->json(['message' => 'Order placed successfully', 'order_id' => $order->id]);
}

}`

이 예에서는 주문 생성과 이벤트 전달을 데이터베이스 트랜잭션으로 래핑하여 둘 다 성공적으로 발생하는지 아니면 전혀 발생하지 않는지 확인했습니다.