Pular para o conteúdo principal

Tarefas cron

A ferramenta Tarefas cron permite agendar comandos para rodar em um timer — de uma tarefa rápida "a cada minuto" até o agendador do Laravel.

Criando uma tarefa​

Cada tarefa tem:

  • Nome — um rótulo para você encontrá-la depois.
  • Agendamento — uma expressão cron de 5 ou 6 campos, ou um descritor como @daily, @hourly ou @every 5m.
  • Comando — o que executar.
  • Diretório de trabalho (opcional) — onde o comando roda.
  • Override de versão do PHP (opcional) — fixe uma versão do PHP específica para esta tarefa.

Vincular uma tarefa a um projeto​

Vincule uma tarefa a um projeto para herdar automaticamente o diretório de trabalho e a versão do PHP daquele projeto, sem precisar configurá-los manualmente. Veja Servidor de desenvolvimento e fila para tarefas relacionadas por projeto.

Modo em segundo plano​

Por padrão, uma tarefa roda no processo — apenas enquanto o app do LaraEnv está aberto.

Ative o Modo em segundo plano para registrar a tarefa no Agendador de Tarefas do Windows. A tarefa passa a rodar mesmo quando o LaraEnv está fechado.

Histórico de execuções​

Cada tarefa mantém um histórico de execuções:

  • Última execução
  • Status — ok, error ou running
  • Saída capturada — truncada em cerca de 8 KB
  • Erro — se a execução falhou

Use Executar agora para disparar uma tarefa imediatamente, e Ativar/Desativar para pausar uma tarefa sem excluí-la.

Presets e modelos​

Modelos rápidos para começar logo:

  • A cada minuto
  • A cada 5 minutos
  • A cada hora
  • Diariamente às 03:00
  • O agendador do Laravel (php artisan schedule:run)

Exemplo do agendador do Laravel​

Para acionar o agendador do Laravel, execute php artisan schedule:run a cada minuto:

* * * * *    php artisan schedule:run

Vincule a tarefa ao seu projeto Laravel para que ela herde o diretório de trabalho e a versão do PHP corretos.

dica

Use o filtro de projeto para mostrar apenas as tarefas que pertencem a um determinado projeto.