Kaip veikia eilėje laukiantys darbai (queued jobs) Laravel?

Question

Accepted Answer

Laravel **eilės sistema** leidžia atidėti daug laiko pareikalaujancius uždavinius (el. laiškų siuntimą, failų apdorojimą, lėtų API kvietimus) į **foninį procesą**, todėl vartotojas gauna greitą atsakymą. Uždaviniai yra ypatingi **darbai** (Jobs), įdedami į eilę ir apdoroti atskiri **worker** procesai.

## Problemos, kurias išsprendžia eilės

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

## Darbo apibrėžimas ir išsiuntimas

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

Gramatika `ShouldQueue` darį darbą eilėje galimą. `dispatch()` jį nustumia į eilę ir iš karto grąžina — vartotojas nelauke darbo.

## Darbų apdorojimas (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
```

Atskiras **worker** procesas paima darbus iš eilės ir juos vykdo. Eilės sistemos apima Redis, duomenų bazę, SQS ir kt.

## Patikimų savybės

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

## Kodėl tai svarbu

Eilėje laukiantys darbai yra būtini kurant greitai reaguojančias ir mastintinas Laravel programas — atidėti lėtus arba atidėtus uždavinius iš užklausos ciklo yra dažna ir svarbi poreikis, o Laravel eilės sistema tai daro elegantiškai.

Supratimas yra naudingas, nes laiko pareikalaunančio darbo atlikimas tiesiogiai (el. laiškų siuntimas, medijos apdorojimas, ataskaitų generavimas, lėtų išorinių paslaugų kvietimai) priverčia laukti vartotojus, rizikuoja užklausos laiko viršijimu ir gali prarasti darbą, jei jis nepavyks — o **eilėje** jį norint galite iš karto atsakyti vartotojui, o fonas **worker** tai apdoroja patikimai.

Be paprasto asinchroninio atidėjimo, Laravel eilės suteikia svarbias gamybos galimybes: **automatiniai bandymai su atidėjimu** (atsparumas trumpalaikėms klaidoms), **persistence** (darbai išlieka po kritimų/paleidimų eilės back-ende, todėl darbas neprarandamas), nepavykusio darbo tvarkymas, atidėtas išsiuntimas ir stebėjimas per Horizon.

Supratimas, kaip apibrėžti darbus (`ShouldQueue`), juos išsiųsti (iš karto grąžinti), juos apdoroti su worker (`queue:work`, prižiūrimas gamyboje) ir konfigūruoti patikimų savybes yra svarbi žinia, skirta programoms, kurios sunkius arba atidėtus darbus gali atlikti grakščiai.

Kadangi greitai reaguojančios programos dažnai turi atidėti darbą į foną — ir nes Laravel eilės sistema yra elegantiškas, idiominis būdas tai daryti su integruota patikimumu — valdyti darbus ir eiles yra dažnai aktualus, svarbi žinia, skirta kurti gamybos lygio Laravel programas, kurios išlieka greitai veikiančios ir patikimos realiomis darbo apkrovomis.