Pular para o conteúdo
Documentação

Tarefas agendadas (Cron Jobs)

Agende comandos para rodar automaticamente, como o scheduler do Laravel e o cron do Magento 2, e edite, pause ou remova tarefas.

R Regis Manze 20/11/2026 3 min de leitura

A tela Cron Jobs agenda comandos para rodar sozinhos em horários definidos, como o scheduler do Laravel, o cron do Magento 2 ou um script PHP de rotina. As tarefas rodam com o seu usuário, com as mesmas permissões da sua conta.

Lista de tarefas

Coluna O que mostra
Status Ativo ou Desabilitado
Agendamento A expressão de horário (ex.: */5 * * * *) e uma descrição em texto, como "A cada 5 min"
Comando O que será executado
Acoes Habilitar/Desabilitar, Editar e Excluir

Como funciona o agendamento

O horário tem cinco campos, nesta ordem:

Campo Valores Exemplo
Minuto 0 a 59 30
Hora 0 a 23 2
Dia 1 a 31 1
Mes 1 a 12 *
Semana 0 a 7 (0 e 7 = domingo) 1-5
  • * significa "todos";
  • */5 significa "a cada 5";
  • 1,15 são valores específicos;
  • 1-5 é um intervalo.

Exemplos prontos (também aparecem em Exemplos Comuns):

Expressão Quando roda
* * * * * A cada minuto
*/5 * * * * A cada 5 minutos
0 * * * * A cada hora
0 0 * * * Todo dia à meia-noite
0 3 * * 0 Todo domingo às 3h
0 0 1 * * Primeiro dia do mês
30 2 * * 1-5 Segunda a sexta às 2h30

Atenção: só números e os símbolos * , / - são aceitos. Atalhos como @daily ou nomes de dias (mon) não funcionam. O horário é o do servidor.

Criar uma tarefa

  1. Clique em Novo Cron Job.
  2. Preencha Minuto, Hora, Dia, Mes e Semana, ou clique em um dos Atalhos: A cada min, 5 min, 15 min, 30 min, 1 hora, Diario, Semanal ou Mensal.
  3. Em Comando, escreva o comando completo, com caminhos absolutos.
  4. Clique em Adicionar.

Use o PHP da mesma versão do seu site. O quadro Caminhos PHP mostra exemplos como /usr/bin/php8.3. Confira a versão do seu domínio em Meus Dominios.

Passo a passo: agendar o cron do Laravel

O Laravel precisa de uma única tarefa que roda a cada minuto e dispara todos os agendamentos definidos no código.

  1. Clique em Novo Cron Job.

  2. Clique no atalho A cada min (fica * * * * *).

  3. Em Comando, digite (troque cliente pelo seu usuário e 8.3 pela versão do PHP do site):

    /usr/bin/php8.3 /home/cliente/public_html/artisan schedule:run >> /dev/null 2>&1
    
  4. Clique em Adicionar.

Dica: se preferir, use o modelo Laravel Scheduler na tela Servicos, que faz o mesmo trabalho como serviço. Use só um dos dois, nunca os dois juntos, ou as tarefas do Laravel rodarão em dobro.

Passo a passo: cron do Magento 2

  1. Clique em Novo Cron Job e no atalho A cada min.

  2. Em Comando:

    /usr/bin/php8.3 /home/cliente/public_html/bin/magento cron:run >> /home/cliente/logs/magento-cron.log 2>&1
    
  3. Clique em Adicionar.

Editar, pausar e excluir

  • Editar: abre a janela Editar Cron Job. Altere e clique em Salvar.
  • Desabilitar: pausa a tarefa sem apagá-la. Ela aparece como Desabilitado. Clique em Habilitar para voltar.
  • Excluir: remove a tarefa de vez, após confirmação.

Dicas para tarefas confiáveis

  • Sempre use caminhos completos (/usr/bin/php8.3, /home/cliente/...).
  • Guarde a saída em um arquivo de log para investigar falhas, como no exemplo do Magento acima.
  • Evite tarefas pesadas a cada minuto. Se uma execução demora mais que o intervalo, as próximas se acumulam.
  • Teste o comando antes no Terminal: se não funcionar lá, também não funcionará no cron.
Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!