Come funziona la pianificazione dei task?

Question

Accepted Answer

Lo **scheduler dei task** di Laravel ti permette di definire task pianificati (ricorrenti) — come report giornalieri, pulizia o invio di promemoria — fluidamente **nel codice**, invece di gestire molti singoli entry cron. Un singolo entry cron esegue lo scheduler di Laravel, che a sua volta esegue i tuoi task definiti nei loro orari pianificati.

## Perché è importante

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

## Definire task pianificati (nel codice)

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

I task sono definiti con un'**API fluente e leggibile** — puoi pianificare comandi Artisan, job in coda o closure con metodi di frequenza espressivi (`daily()`, `everyFifteenMinutes()`, `dailyAt()`), tutto nel codice versionato invece di sparsi tra entry crontab.

## Il singolo entry cron che lo alimenta

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

Questo singolo entry esegue `schedule:run` ogni minuto; Laravel controlla quali dei tuoi task definiti sono scaduti e li esegue. Non dovrai mai più toccare il crontab — tutta la pianificazione vive nel codice.

## Opzioni utili

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

## Perché è importante

La pianificazione dei task è importante per qualsiasi applicazione con **lavoro ricorrente in background** — report giornalieri, pulizia periodica, invio di promemoria/digest, sincronizzazione dati, elaborazione di batch — che è un'esigenza comune, e lo scheduler di Laravel rende la gestione di tali task molto più pulita rispetto al cron tradizionale.

Il vantaggio principale è definire tutti i task pianificati **fluidamente nel codice versionato** invece che come entry crontab sparsi e specifici del server: questo mantiene la logica di pianificazione con la tua applicazione (revisionabile, deployabile, coerente tra ambienti) e utilizza un'API espressiva (`daily()`, `everyFifteenMinutes()`, `dailyAt()`) molto più leggibile della sintassi cron.

Il design intelligente — un **singolo entry cron** che esegue `schedule:run` ogni minuto, il quale poi esegue i tuoi task scaduti — significa che configuri cron una sola volta e non lo tocchi più, gestendo tutta la pianificazione nel codice.

Capire come definire task pianificati (comandi, job, closure con metodi di frequenza), la configurazione del singolo entry cron e le opzioni utili (`withoutOverlapping`, `onOneServer` per la sicurezza multi-server) è una conoscenza preziosa per costruire applicazioni che eseguono lavoro automatizzato ricorrente.

Poiché i task pianificati/periodici sono un requisito frequente nel mondo reale, e poiché lo scheduler di Laravel fornisce un'alternativa pulita, versionata ed espressiva alla gestione di raw entry cron, sapere come funziona la pianificazione dei task è una conoscenza importante a livello senior per costruire applicazioni mantenibili con operazioni ricorrenti automatizzate — un'esigenza comune e pratica che lo scheduler gestisce elegantemente.