Bagaimanakah queued job berfungsi dalam Laravel?

Question

Accepted Answer

**Sistem queue** Laravel membolehkan anda menangguhkan tugas yang memakan masa (menghantar e-mel, memproses fail, memanggil API yang lambat) untuk berjalan **di latar belakang**, supaya pengguna mendapat respons yang pantas. Tugas dirangkumkan sebagai **Job**, ditolak ke queue, dan diproses oleh proses **worker** yang berasingan.

## Masalah yang diselesaikan queue

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

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

Melaksanakan `ShouldQueue` menjadikan sesuatu job boleh di-queue. `dispatch()` menolaknya ke queue dan kembali serta-merta — pengguna tidak menunggu kerja itu.

## Memproses job (worker)

```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** berasingan menarik job daripada queue dan menjalankannya. Backend queue termasuk Redis, pangkalan data, SQS, dan lain-lain.

## Ciri kebolehpercayaan

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

Queued job adalah penting untuk membina aplikasi Laravel yang responsif dan boleh skala — memunggah kerja yang lambat atau ditangguh daripada kitaran permintaan adalah keperluan lazim dan penting, dan sistem queue Laravel menjadikannya elegan.

Memahaminya berharga kerana melakukan kerja yang memakan masa secara inline (menghantar e-mel, memproses media, menjana laporan, memanggil perkhidmatan luaran yang lambat) menjadikan pengguna menunggu, berisiko request timeout, dan kehilangan kerja itu jika gagal — sedangkan **mengqueue**nya membolehkan anda merespons pengguna serta-merta manakala **worker** latar belakang memprosesnya dengan boleh dipercayai.

Di luar pemunggahan async ringkas, queue Laravel menyediakan keupayaan pengeluaran yang penting: **percubaan semula automatik dengan backoff** (ketahanan terhadap kegagalan sementara), **ketekalan (persistence)** (job bertahan terhadap kerosakan/mula semula melalui backend queue, jadi kerja tidak hilang), pengendalian failed-job, dispatch tertunda, dan pemantauan melalui Horizon.

Memahami cara mentakrifkan job (`ShouldQueue`), mendispatchnya (kembali serta-merta), memprosesnya dengan worker (`queue:work`, diselia dalam pengeluaran), dan mengkonfigurasi ciri kebolehpercayaan adalah pengetahuan penting untuk membina aplikasi yang mengendalikan kerja berat atau ditangguh dengan anggun.

Memandangkan aplikasi yang responsif lazimnya perlu memunggah kerja ke latar belakang — dan memandangkan sistem queue Laravel adalah cara yang elegan dan idiomatik untuk melakukannya dengan kebolehpercayaan terbina dalam — menguasai job dan queue adalah pengetahuan penting yang kerap berkaitan untuk membina aplikasi Laravel gred pengeluaran yang kekal pantas dan boleh dipercayai di bawah beban kerja dunia sebenar.