작업 생성 및 디스패치
Artisan으로 작업 클래스를 생성하고 컨트롤러에서 디스패치합니다.
작업 생성 및 디스패치은(는) CoddyKit의 무료 PHP Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 PHP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. PHP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
작업이란 무엇인가요
작업은 대기열에 넣을 작업 단위를 하나로 묶은 PHP 클래스입니다. 각 작업은 handle()을 구현하며, 대기열 작업자가 이를 호출하여 작업을 실행합니다.
작업 생성하기
Artisan을 사용하여 작업 클래스를 생성합니다. --queue 플래그를 사용하면 대기열에 넣을 수 있습니다(기본값).
$ php artisan make:job SendWelcomeEmail작업 클래스 구조
작업에는 handle() 메서드가 있으며 생성자를 통해 데이터를 전달받을 수 있습니다.
<?php
namespace App\Jobs;
use App\Models\User;
use App\Mail\WelcomeEmail;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\SerializesModels;
class SendWelcomeEmail implements ShouldQueue
{
use Dispatchable, Queueable, SerializesModels;
public function __construct(private User $user) {}
public function handle(): void
{
Mail::to($this->user)->send(new WelcomeEmail($this->user));
}
}작업 디스패치하기
애플리케이션의 어느 위치에서든 작업을 디스패치할 수 있습니다.
<?php
// Dispatch to queue:
SendWelcomeEmail::dispatch($user);
// Dispatch with delay:
SendWelcomeEmail::dispatch($user)->delay(now()->addMinutes(10));
// Dispatch synchronously (bypass queue):
SendWelcomeEmail::dispatchSync($user);디스패치 도우미
dispatch() 전역 도우미를 사용할 수도 있습니다.
<?php
dispatch(new SendWelcomeEmail($user))
->onQueue("emails")
->delay(now()->addHour());onQueue()
디스패치할 때 특정 이름의 대기열을 대상으로 지정합니다.
<?php
SendWelcomeEmail::dispatch($user)->onQueue("emails");onConnection()
특정 대기열 연결을 대상으로 지정합니다(예: 한 작업에는 SQS, 다른 작업에는 Redis).
<?php
SendWelcomeEmail::dispatch($user)->onConnection("sqs");모델 직렬화하기
SerializesModels 특성은 작업에 전달된 Eloquent 모델을 ID로 직렬화하고 작업자가 데이터베이스에서 다시 가져오도록 하여 오래된 데이터를 사용하지 않게 합니다.
afterResponse()
HTTP 응답을 사용자에게 보낸 후 작업을 디스패치하므로 사용자는 디스패치에 필요한 추가 처리 시간을 기다리지 않습니다.
<?php
App::terminating(fn () => SendWelcomeEmail::dispatch($user));작업 테스트하기
테스트에서 Queue::fake()를 사용하면 작업을 실제로 실행하지 않고도 작업이 디스패치되었는지 확인할 수 있습니다.
<?php
Queue::fake();
$this->post("/register", $data);
Queue::assertPushed(SendWelcomeEmail::class);고유 작업
ShouldBeUnique를 구현하면 동일한 데이터에 대한 중복 작업이 대기열에 쌓이는 것을 방지할 수 있습니다.
요약
Artisan으로 작업을 생성합니다. ShouldQueue와 handle()을 구현하고, ::dispatch()로 디스패치합니다. onQueue()로 대기열을 지정하고, Queue::fake()로 테스트합니다.
빠른 확인
작업 클래스를 대기열에 넣을 수 있도록 하는 인터페이스는 무엇인가요?
자주 묻는 질문
“작업 생성 및 디스패치” 강의는 무료인가요?
네 — “작업 생성 및 디스패치” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 PHP Academy 강의 전체를 잠금 해제할 수 있습니다. PHP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“작업 생성 및 디스패치”에서 뭘 배우나요?
Artisan으로 작업 클래스를 생성하고 컨트롤러에서 디스패치합니다. 브라우저에서 직접 실행하는 실습 코드로 PHP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
PHP Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 PHP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“작업 생성 및 디스패치” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 PHP Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 PHP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.