Kaip veikia užduočių planavimas?

Question

Accepted Answer

Laravel **užduočių planuotojas** leidžia apibrėžti suplanuotas (pasikartojančias) užduotis — pavyzdžiui, kasdienius ataskaitas, valymo operacijas arba priminimų siuntimą — sklandžiai **kode**, vietoj to, kad tvarkytumėte daugybę atskirų cron įrašų. Vienas cron įrašas vykdo Laravel planuotoją, kuris tada vykdo jūsų apibrėžtas užduotis jų suplanuotais laikais.

## Problemą, kurią ji sprendžia

```text
Traditionally, each recurring task needs its own crontab entry on the server
→ scattered, hard to version-control, server-specific, error-prone.
Laravel: define ALL scheduled tasks in code (version-controlled), with ONE cron entry.
```

## Suplanuotų užduočių apibrėžimas (kode)

```php
<?php
// in the schedule definition (app/Console/Kernel.php or routes/console.php)
$schedule->command('reports:generate')->daily();
$schedule->command('emails:reminders')->hourly();
$schedule->job(new CleanupJob)->everyFifteenMinutes();
$schedule->call(fn() => DB::table('sessions')->where(...)->delete())->dailyAt('02:00');

// expressive frequency methods:
->everyMinute() ->hourly() ->daily() ->weekly() ->monthly()
->dailyAt('13:00') ->weekdays() ->cron('0 0 * * *')   // or a raw cron expression
```

Užduotys apibrėžiamos naudojant **sklandžią, lengvai skaitomą API** — galite planuoti Artisan komandas, suplanuotus darbus arba uždarus modulius naudodami išraiškingas dažnio metodus (`daily()`, `everyFifteenMinutes()`, `dailyAt()`), viskas versijų kontroliavimo sistemoje saugomame kode, o ne išsibarsčiusiuose crontab įrašuose.

## Vienas cron įrašas, kuris jį varo

```bash
# add ONE cron entry on the server — runs the scheduler every minute
* * * * * cd /path-to-app && php artisan schedule:run >> /dev/null 2>&1
```

Šis vienas įrašas vykdo `schedule:run` kas minutę; Laravel patikrina, kurios iš jūsų apibrėžtų užduočių yra mokingos, ir jas vykdo. Jūs niekada neliečiate crontab — visa planavimas gyvena kode.

## Naudingi variantai

```php
$schedule->command('backup')->daily()
    ->withoutOverlapping()        // don't start if the previous run is still going
    ->onOneServer()                // in multi-server setups, run on only ONE server
    ->emailOutputOnFailure('ops@x.com');
```

## Kodėl tai svarbu

Užduočių planavimas yra svarbus bet kokiai aplikacijai su **pasikartojančiais foninio darbo procesais** — kasdieninėmis ataskaitomis, periodišku valymų, priminimų/sujungti tiesioginės siuntos siuntimais, duomenų sinkronizavimų, paketų apdorojimu — o tai yra dažna poreikis, ir Laravel planuotojas tokias užduotis tvarkyt daro daug švariau nei tradicinis cron.

Pagrindinė nauda yra apibrėžti visas suplanuotas užduotis **sklandžiai versijų kontroliavimo sistemoje saugomame kode**, o ne kaip išsibarsčiusius, specifiniams serveriams skirtus crontab įrašus: tai užduočių logika laiką su jūsų aplikacija (peržiūrima, diegiama, nuosekli visuose aplinkose) ir naudoja išraiškiną API (`daily()`, `everyFifteenMinutes()`, `dailyAt()`), kuri yra daug labiau skaitoma nei cron sintaksė.

Šauni konstrukcija — **vienas cron įrašas** vykdantis `schedule:run` kas minutę, kuris tada vykdo jūsų mokingos užduotis — reiškia, kad jūs nustatote cron vieną kartą ir niekada jo nebeliečiate, tvarkydami visą planavimą kode.

Supratimas, kaip apibrėžti suplanuotas užduotis (komandas, darbus, uždarus modulius su dažnio metodais), vieno-cron-įrašo nustatymo, ir naudingų variantų (`withoutOverlapping`, `onOneServer` daugiaserverinio saugumo garantijai) yra vertingas žinojimas kuriant aplikacijas, kurios vykdo pasikartojantį automatinį darbą.

Kadangi suplanuotos/periodinės užduotys yra dažnas realaus pasaulio reikalavimas, ir kadangi Laravel planuotojas suteikia švarią, versijų kontroliavimo sistemoje saugomą, išraiškiną alternatyvą žaliajam cron įrašų tvarkymuim, žinojimas, kaip veikia užduočių planavimas, yra svarbus aukšto lygio žinojimas kuriant saugias aplikacijas su automatizuotomis pasikartojančiomis operacijomis — dažna, praktiška poreikis, kurį planuotojas sprendžia elegantiškai.