Como funciona o agendamento de tarefas?

Question

Accepted Answer

O **task scheduler** do Laravel permite que você defina tarefas agendadas (recorrentes) — como relatórios diários, limpeza ou envio de lembretes — de forma fluida **no código**, em vez de gerenciar muitas entradas cron individuais. Uma única entrada cron executa o scheduler do Laravel, que então executa suas tarefas definidas nos seus horários agendados.

## O problema que resolve

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

## Definindo tarefas agendadas (no código)

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

As tarefas são definidas com uma **API fluida e legível** — você pode agendar comandos Artisan, jobs enfileirados ou closures com métodos de frequência expressivos (`daily()`, `everyFifteenMinutes()`, `dailyAt()`), tudo em código versionado em vez de entradas crontab espalhadas.

## A única entrada cron que a conduz

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

Esta única entrada executa `schedule:run` a cada minuto; o Laravel verifica quais de suas tarefas definidas estão vencidas e as executa. Você nunca toca no crontab novamente — todo agendamento fica no código.

## Opções úteis

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

## Por que isso importa

O agendamento de tarefas é importante para qualquer aplicação com **trabalho recorrente em segundo plano** — relatórios diários, limpeza periódica, envio de lembretes/digests, sincronização de dados, processamento em lote — que é uma necessidade comum, e o scheduler do Laravel torna o gerenciamento de tais tarefas muito mais limpo do que o cron tradicional.

O benefício principal é definir todas as tarefas agendadas **de forma fluida em código versionado** em vez de como entradas crontab espalhadas e específicas do servidor: isso mantém a lógica de agendamento com sua aplicação (revisável, deployável, consistente entre ambientes) e usa uma API expressiva (`daily()`, `everyFifteenMinutes()`, `dailyAt()`) que é muito mais legível do que a sintaxe cron.

O design inteligente — uma **única entrada cron** executando `schedule:run` a cada minuto, que então executa suas tarefas vencidas — significa que você configura cron uma vez e nunca toca novamente, gerenciando todo agendamento no código.

Compreender como definir tarefas agendadas (comandos, jobs, closures com métodos de frequência), a configuração de entrada única em cron, e opções úteis (`withoutOverlapping`, `onOneServer` para segurança multi-servidor) é conhecimento valioso para criar aplicações que realizam trabalho recorrente automatizado.

Como tarefas agendadas/periódicas são um requisito comum no mundo real, e como o scheduler do Laravel fornece uma alternativa limpa, versionada e expressiva para gerenciar entradas cron brutas, saber como o agendamento de tarefas funciona é conhecimento importante de nível sênior para construir aplicações mantíveis com operações recorrentes automatizadas — uma necessidade comum e prática que o scheduler trata elegantemente.