Cum funcționează planificarea taskurilor?

Question

Accepted Answer

Planificatorul de taskuri al Laravel-ului permite definirea taskurilor planificate (recurente) — cum ar fi rapoarte zilnice, curățare sau trimiterea de reamintiri — fluent **în cod**, în loc să gestionați multe intrări cron individuale. O singură intrare cron execută planificatorul Laravel, care apoi execută taskurile dvs. definite la orele planificate.

## Problema pe care o rezolvă

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

## Definirea taskurilor planificate (în cod)

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

Taskurile sunt definite cu un **API fluent și ușor de citit** — puteți planifica comenzi Artisan, joburi în coadă sau closure-uri cu metode de frecvență expresive (`daily()`, `everyFifteenMinutes()`, `dailyAt()`), toate în cod gestionat de versiuni în loc să fie dispersate în intrări crontab.

## Intrarea cron unică care o conduce

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

Această singură intrare execută `schedule:run` în fiecare minut; Laravel verifică care dintre taskurile dvs. definite sunt datorate și le execută. Nu mai atingeți crontab-ul — toată planificarea trăiește în cod.

## Opțiuni utile

```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');
```

## De ce contează

Planificarea taskurilor este importantă pentru orice aplicație cu **lucru recurent în fundal** — rapoarte zilnice, curățare periodică, trimiterea de reamintiri/digeste, sincronizarea datelor, procesarea în loturi — ceea ce este o nevoie comună, iar planificatorul Laravel face gestionarea unor astfel de taskuri mult mai curată decât cron tradițional.

beneficiul esențial este definirea tuturor taskurilor planificate **fluent în cod gestionat de versiuni** în loc de intrări crontab dispersate și specifice serverului: aceasta ține logica planificării cu aplicația dvs. (revizuibilă, implementabilă, consecventă în toate mediile) și utilizează un API expresiv (`daily()`, `everyFifteenMinutes()`, `dailyAt()`) care este mult mai ușor de citit decât sintaxa cron.

Designul inteligent — o **singură intrare cron** care execută `schedule:run` în fiecare minut, care apoi execută taskurile dvs. datorate — înseamnă că configurați cron o dată și nu mai atingeți niciodată, gestionând toată planificarea în cod.

Înțelegerea modului de definire a taskurilor planificate (comenzi, joburi, closure-uri cu metode de frecvență), configurația cu intrare cron unică și opțiuni utile (`withoutOverlapping`, `onOneServer` pentru siguranță pe mai mulți serveri) este cunoaștere valoroasă pentru construirea aplicațiilor care efectuează lucrul automat recurent.

Deoarece taskurile planificate/periodice sunt o cerință frecventă în lumea reală, și deoarece planificatorul Laravel oferă o alternativă curată, gestionată de versiuni și expresivă la gestionarea intrărilor cron brute, cunoașterea modului în care funcționează planificarea taskurilor este cunoaștere importantă la nivel senior pentru construirea aplicațiilor ușor de întreținut cu operațiuni recurente automate — o nevoie comună și practică pe care planificatorul o gestionează elegant.