Base de Conhecimento

Um Cron Job é uma tarefa agendada que o sistema executa automaticamente em horários ou intervalos predefinidos.

Normalmente, ele é usado para executar scripts e rotinas como:

• tarefas automáticas de sites e sistemas;
• processamento de filas;
• importações e exportações agendadas;
• limpeza de cache;
• rotinas de manutenção.

1. Entre no cPanel.
2. Vá até a seção Advanced (Avançado).
3. Clique em Cron Jobs.

Na interface Cron Jobs, normalmente você verá:

• Cron Email — email para receber a saída das tarefas;
• Common Settings (Configurações Comuns) — intervalos prontos;
• os campos Minute, Hour, Day, Month e Weekday;
• o campo Command (Comando).

O menu Common Settings (Configurações Comuns) permite escolher intervalos prontos. Quando você seleciona uma opção, o cPanel preenche automaticamente os campos de tempo para você.

Exemplos comuns:

• Once Per Minute — uma vez por minuto
• Once Per Five Minutes — uma vez a cada 5 minutos
• Once Per Hour — uma vez por hora
• Twice Per Day — duas vezes por dia
• Once Per Day — uma vez por dia
• Once Per Week — uma vez por semana
• Once Per Month — uma vez por mês

O agendamento do Cron Job é definido em cinco campos:

Minute   Hour   Day   Month   Weekday

Cada um deles define quando a tarefa será executada.

Minute — define o minuto da hora em que o Cron vai rodar, ou o intervalo em minutos.
Exemplo: 15 = rodar aos 15 minutos de cada hora.

Hour — define a hora do dia em que o Cron vai rodar.
Exemplo: 21 = rodar às 21h.

Day — define o dia do mês em que o Cron vai rodar.
Exemplo: 15 = rodar no dia 15 de cada mês.

Month — define o mês do ano em que o Cron vai rodar.
Exemplo: 7 = rodar em julho.

Weekday — define o dia da semana em que o Cron vai rodar.
Exemplo: 0 = domingo, 6 = sábado.

O caractere * significa todos os valores possíveis naquele campo.

Exemplos:

• * em Minute = todos os minutos;
• * em Hour = todas as horas;
• * em Day = todos os dias do mês;
• * em Month = todos os meses;
• * em Weekday = todos os dias da semana.

O próprio cPanel usa este exemplo para explicar o preenchimento:

Minute   15
Hour     21
Day      *
Month    *
Weekday  *

Isso significa: executar todos os dias às 21:15.

A cada minuto

* * * * *

A cada 5 minutos

*/5 * * * *

A cada 30 minutos

*/30 * * * *

Uma vez por hora, no minuto 0

0 * * * *

Todo dia à meia-noite

0 0 * * *

Todo dia às 3:30 da manhã

30 3 * * *

Toda segunda-feira às 8:00

0 8 * * 1

Todo dia 1 de cada mês às 2:00

0 2 1 * *

Todo domingo às 23:00

0 23 * * 0

Se você quiser, por exemplo, rodar um script todos os dias às 2:30 da manhã, preencha assim:

• Minute: 30
• Hour: 2
• Day: *
• Month: *
• Weekday: *

Se quiser rodar a cada 5 minutos:

• Minute: */5
• Hour: *
• Day: *
• Month: *
• Weekday: *

Depois de definir o tempo, informe no campo Command (Comando) o comando completo que o sistema deve executar.

Exemplo usando PHP:

/usr/local/bin/php /home/usuario/public_html/script.php

O cPanel recomenda usar o caminho absoluto do comando ou script.

Se o seu Cron Job executar um script personalizado, esse script precisa ter permissão de execução.

chmod 755 script.sh

Isso é especialmente importante em scripts .sh, .pl e outros executados diretamente.

Na parte Cron Email, você pode informar um email para receber notificações e saídas dos trabalhos agendados.

Para cadastrar:

1. digite o email desejado;
2. clique em Update Email (Atualizar Email).

Para desativar emails de todos os Cron Jobs, remova o endereço em Cron Email.

Para desativar a saída de um único Cron Job, o cPanel orienta adicionar ao final do comando:

/dev/null 2>&1

Exemplo:

/usr/local/bin/php /home/usuario/public_html/script.php /dev/null 2>&1

Depois de preencher:

• Minute;
• Hour;
• Day;
• Month;
• Weekday;
• Command;

clique em Add New Cron Job (Adicionar Novo Cron Job).

Na tabela Current Cron Jobs (Cron Jobs Atuais), você pode:

• clicar em Edit (Editar) para alterar horário ou comando;
• clicar em Delete (Excluir) para remover a tarefa.

Para evitar problemas:

• não use intervalos curtos demais sem necessidade;
• prefira horários fora de pico para tarefas pesadas;
• use caminhos absolutos;
• garanta permissão de execução para scripts personalizados;
• teste o comando manualmente antes, se possível.

Um Cron Job completo no cPanel exige:

• definir corretamente Minute, Hour, Day, Month e Weekday;
• entender que * significa todos os valores daquele campo;
• informar um Command válido com caminho absoluto;
• dar permissão de execução ao script, se necessário;
• configurar ou desativar o email de saída conforme sua necessidade.