Laravel'de sıraya alınan işler (queued jobs) nasıl çalışır?

Question

Accepted Answer

Laravel'in **kuyruk sistemi**, zaman alan görevleri (email gönderme, dosya işleme, yavaş API çağrıları) **arka planda** çalışması için ertelemenize izin verir; böylece kullanıcı hızlı bir yanıt alır. Görevler **Jobs** olarak kapsüllenir, bir kuyruğa itilir ve ayrı **worker** işlemleri tarafından işlenir.

## Kuyrukların çözdüğü sorun

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

## İş tanımlama ve gönderme

```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` uygulamak, bir işi kuyruklanabilir hale getirir. `dispatch()` onu kuyruğa iter ve hemen döner — kullanıcı işin tamamlanmasını beklemez.

## İşleri işleme (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
```

Ayrı bir **worker** işlemi, kuyruktaki işleri alır ve çalıştırır. Kuyruk arka uçları Redis, veritabanı, SQS vb. içerir.

## Güvenilirlik özellikleri

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

## Neden önemli

Sıraya alınan işler, duyarlı ve ölçeklenebilir Laravel uygulamaları oluşturmak için gereklidir — yavaş veya ertelenmiş işi istek döngüsünden uzaklaştırmak yaygın ve önemli bir ihtiyaçtır ve Laravel'in kuyruk sistemi bunu zarif hale getirir.

Bunu anlamak değerlidir çünkü zaman alan işleri satır içi gerçekleştirmek (email gönderme, medya işleme, rapor oluşturma, yavaş dış hizmetleri çağırma) kullanıcıların beklemesini sağlar, istek zaman aşımı riskiyle karşı karşıya kalır ve başarısız olursa işi kaybeder — oysa bunu **kuyruğa almak** kullanıcıya hemen yanıt vermenizi sağlar ve bir arka plan **worker** onu güvenilir şekilde işler.

Basit async uzaklaştırmanın ötesinde, Laravel'in kuyrukları önemli üretim yetenekleri sağlar: **otomatik yeniden denemeler (backoff ile)** (geçici hataylara karşı esneklik), **kalıcılık** (işler kuyruk arka ucu aracılığıyla çökmelerden/yeniden başlatmalardan kurtulur, bu nedenle iş kaybedilmez), başarısız iş işleme, ertelenmiş gönderme ve Horizon aracılığıyla izleme.

İş tanımlama (`ShouldQueue`), bunları gönderme (hemen döndürme), işçilerle işleme (`queue:work`, üretimde denetim altında) ve güvenilirlik özelliklerini yapılandırma hakkında bilgi sahibi olmak, ağır veya ertelenmiş işi zarif bir şekilde işleyen uygulamalar oluşturmak için önemli bilgidir.

Duyarlı uygulamalar rutin olarak işi arka plana uzaklaştırmaya ihtiyaç duyduğundan — ve Laravel'in kuyruk sistemi bunu yerleşik güvenilirlikle yapmanın zarif, idiyomatik yolu olduğundan — işler ve kuyruklar hakkında uzmanlaşmak, gerçek dünya iş yükleri altında hızlı ve güvenilir kalan üretim sınıfı Laravel uygulamaları oluşturmak için sıklıkla ilgili, önemli bilgidir.