Laravel のキューに入れられたジョブはどのように機能するのか？

Question

Accepted Answer

Laravel の **キューシステム** を使うと、時間がかかるタスク (メール送信、ファイル処理、遅いAPI呼び出し) を **バックグラウンド** で実行できるため、ユーザーは高速なレスポンスを得られます。タスクは **Job** としてカプセル化され、キューにプッシュされ、別の **ワーカー** プロセスで処理されます。

## キューが解決する問題

```text
Slow work done inline makes the user wait and risks request timeouts:
  ✗ sending emails, processing images/video, generating reports, calling slow APIs
  ✓ QUEUE it → respond to the user immediately → a worker handles it in the background
```

## ジョブの定義とディスパッチ

```php
<?php
// php artisan make:job ProcessPodcast
class ProcessPodcast implements ShouldQueue {
    public function __construct(public Podcast $podcast) {}

public function handle(): void {
        // the slow work — runs in a WORKER, not the web request
        $this->podcast->process();
    }
}
```

```php
// dispatch the job — pushes it onto the queue, returns IMMEDIATELY
ProcessPodcast::dispatch($podcast);
ProcessPodcast::dispatch($podcast)->delay(now()->addMinutes(10));   // delayed
```

`ShouldQueue` を実装することでジョブはキューに入れられるようになります。`dispatch()` はジョブをキューにプッシュして直ちに返すため、ユーザーは処理完了を待つ必要がありません。

## ジョブの処理 (ワーカー)

```bash
php artisan queue:work          # run a worker to process queued jobs
# in production: run workers as a supervised process (Supervisor) or use Horizon
```

別の **ワーカー** プロセスがキューからジョブを取得して実行します。キューのバックエンドには Redis、データベース、SQS などが含まれます。

## 信頼性機能

```php
class ProcessPodcast implements ShouldQueue {
    public $tries = 3;             // retry up to 3 times on failure
    public $backoff = 60;          // wait 60s between retries
    public function failed(Throwable $e): void { /* handle final failure */ }
}
```

```text
✓ Retries with backoff (resilience), failed-job handling
✓ Persistence (jobs survive restarts via the queue backend)
✓ Laravel Horizon → a dashboard for monitoring/managing Redis queues
```

## なぜ重要なのか

キューに入れられたジョブは、レスポンシブでスケーラブルな Laravel アプリケーションを構築するために不可欠です。遅いまたは後回しにできる処理をリクエストサイクルからオフロードすることは一般的で重要なニーズであり、Laravel のキューシステムがそれを優雅に実現します。

これを理解することは価値があります。時間がかかる処理 (メール送信、メディア処理、レポート生成、遅い外部サービス呼び出し) をインラインで実行するとユーザーが待つことになり、リクエストタイムアウトのリスクが増し、失敗時に処理が失われます。一方で **キューに入れる** ことで、ユーザーにはすぐにレスポンスできると同時に、バックグラウンド **ワーカー** が信頼性を持って処理を実行できます。

単なる非同期オフロード以上に、Laravel のキューは重要な本番環境機能を提供します。バックオフを伴う **自動リトライ** (一時的な失敗への耐性)、**永続性** (キューバックエンドを通じてジョブが クラッシュ/再起動から保護されるため処理が失われない)、失敗したジョブの処理、遅延ディスパッチ、Horizon を使用した監視などです。

ジョブの定義方法 (`ShouldQueue`)、ディスパッチ方法 (すぐに返す)、ワーカーでの処理方法 (`queue:work`, 本番環境では監視)、信頼性機能の設定方法を理解することは、重い処理または後回しにできる処理を適切に処理するアプリケーションを構築するための重要な知識です。

レスポンシブなアプリケーションは日常的に処理をバックグラウンドにオフロードする必要があり、Laravel のキューシステムが組み込みの信頼性を備えた優雅でイディオマティックな方法であるため、ジョブとキューをマスターすることは、実世界のワークロードの下でも高速で信頼性の高い本番グレードの Laravel アプリケーションを構築するために頻繁に関連する重要な知識です。