Jak działają kolejkowane zadania w Laravel?

Question

Accepted Answer

System **kolejki** Laravel pozwala na odroczenie czasochłonnych zadań (wysyłanie wiadomości email, przetwarzanie plików, wywoływanie wolnych API) na uruchomienie **w tle**, dzięki czemu użytkownik otrzymuje szybką odpowiedź. Zadania są enkapsułowane jako **Jobs**, umieszczane w kolejce i przetwarzane przez oddzielne procesy **worker**.

## Problem, który rozwiązują kolejki

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

## Definiowanie i wysyłanie zadania

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

Implementacja `ShouldQueue` czyni zadanie kolejkowalnym. `dispatch()` umieszcza je w kolejce i zwraca się natychmiast — użytkownik nie czeka na wykonanie pracy.

## Przetwarzanie zadań (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
```

Oddzielny proces **worker** pobiera zadania z kolejki i je wykonuje. Backendy kolejki obejmują Redis, bazę danych, SQS, itd.

## Funkcje niezawodności

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

## Dlaczego to ważne

Zadania w kolejce są niezbędne do budowania responsywnych, skalowalnych aplikacji Laravel — przesunięcie wolnej lub odroczonej pracy z cyklu żądania to powszechna, ważna potrzeba, a system kolejek Laravel to czyni eleganckim.

Zrozumienie tego jest cenne, ponieważ wykonywanie pracy czasochłonnej bezpośrednio (wysyłanie wiadomości email, przetwarzanie mediów, generowanie raportów, wywoływanie wolnych usług zewnętrznych) powoduje, że użytkownicy czekają, ryzyka przekroczenia limitów czasu żądania i utraty pracy w przypadku awarii — natomiast **kolejkowanie** pozwala na natychmiastową odpowiedź użytkownikowi, podczas gdy background **worker** przetwarza to niezawodnie.

Poza prostym asynchronicznym przesunięciem, kolejki Laravel zapewniają ważne możliwości produkcyjne: **automatyczne ponawianie prób z backoff** (odporność na przejściowe awarie), **persystencja** (zadania przeżywają awarie/ponowne uruchomienia za pośrednictwem backendu kolejki, dlatego praca nie zostaje utracona), obsługa zadań nie powiodła się, opóźnione wysyłanie i monitorowanie poprzez Horizon.

Zrozumienie, jak definiować zadania (`ShouldQueue`), wysyłać je (zwracając się natychmiast), przetwarzać je z workers (`queue:work`, nadzorowane w produkcji) i konfigurować funkcje niezawodności to ważna wiedza dla budowania aplikacji, które elegancko obsługują ciężką lub odroczoną pracę.

Ponieważ responsywne aplikacje rutynowo muszą przesunąć pracę do tła — a ponieważ system kolejek Laravel to elegancki, idiomatyczny sposób na zrobienie tego z wbudowaną niezawodnością — opanowanie zadań i kolejek to często istotna, ważna wiedza dla budowania aplikacji Laravel klasy produkcyjnej, które pozostają szybkie i niezawodne przy rzeczywistych obciążeniach.