Bagaimana cara kerja queued jobs di Laravel?

Question

Accepted Answer

Sistem **queue** Laravel memungkinkan Anda menunda tugas-tugas yang memakan waktu (mengirim email, memproses file, memanggil API yang lambat) untuk dijalankan **di latar belakang**, sehingga pengguna mendapatkan respons yang cepat. Tugas-tugas dienkapsulasi sebagai **Jobs**, didorong ke dalam queue, dan diproses oleh proses **worker** terpisah.

## Masalah yang diselesaikan oleh queues

```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
```

## Mendefinisikan dan mendispatch job

```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
```

Mengimplementasikan `ShouldQueue` membuat job dapat diqueuekan. `dispatch()` mendorongnya ke dalam queue dan kembali segera — pengguna tidak perlu menunggu pekerjaan selesai.

## Memproses jobs (workers)

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

Proses **worker** terpisah menarik jobs dari queue dan menjalankannya. Backend queue mencakup Redis, database, SQS, dll.

## Fitur keandalan

```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
```

## Mengapa ini penting

Queued jobs sangat penting untuk membangun aplikasi Laravel yang responsif dan scalable — mengalihkan pekerjaan lambat atau tertunda dari siklus request adalah kebutuhan yang umum dan penting, dan sistem queue Laravel membuatnya elegan.

Memahaminya berharga karena melakukan pekerjaan yang memakan waktu secara inline (mengirim email, memproses media, menghasilkan laporan, memanggil layanan eksternal yang lambat) membuat pengguna menunggu, berisiko timeout request, dan kehilangan pekerjaan jika gagal — sedangkan **queueing** memungkinkan Anda merespons pengguna segera sementara **worker** latar belakang memprosesnya dengan andal.

Beyond simple async offloading, queue Laravel menyediakan kemampuan produksi penting: **automatic retries dengan backoff** (ketahanan terhadap kegagalan transien), **persistence** (jobs bertahan dari crash/restart melalui backend queue, jadi pekerjaan tidak hilang), failed-job handling, delayed dispatch, dan monitoring melalui Horizon.

Memahami cara mendefinisikan jobs (`ShouldQueue`), mendispatchnya (kembali segera), memprosesnya dengan workers (`queue:work`, supervised dalam produksi), dan mengonfigurasi fitur keandalan adalah pengetahuan penting untuk membangun aplikasi yang menangani pekerjaan berat atau tertunda dengan baik.

Karena aplikasi responsif secara rutin perlu mengalihkan pekerjaan ke latar belakang — dan karena sistem queue Laravel adalah cara yang elegan dan idiomatik untuk melakukannya dengan keandalan built-in — menguasai jobs dan queues adalah pengetahuan yang sering relevan dan penting untuk membangun aplikasi Laravel tingkat produksi yang tetap cepat dan andal di bawah beban kerja dunia nyata.