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";*/5significa "a cada 5";1,15sã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@dailyou nomes de dias (mon) não funcionam. O horário é o do servidor.
Criar uma tarefa
- Clique em Novo Cron Job.
- 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.
- Em Comando, escreva o comando completo, com caminhos absolutos.
- 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.
-
Clique em Novo Cron Job.
-
Clique no atalho A cada min (fica
* * * * *). -
Em Comando, digite (troque
clientepelo seu usuário e8.3pela versão do PHP do site):/usr/bin/php8.3 /home/cliente/public_html/artisan schedule:run >> /dev/null 2>&1 -
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
-
Clique em Novo Cron Job e no atalho A cada min.
-
Em Comando:
/usr/bin/php8.3 /home/cliente/public_html/bin/magento cron:run >> /home/cliente/logs/magento-cron.log 2>&1 -
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.