Central de Ajuda

Quando um cron não executa, as causas mais comuns são caminho relativo, binário PHP diferente, permissão, ambiente mínimo, horário ou execução anterior ainda ativa. Teste o comando manualmente com o mesmo usuário antes de alterar o agendamento.

Exemplo seguro

/usr/local/bin/php /home/usuario/app/artisan schedule:run >> /home/usuario/logs/cron.log 2>&1

Confirme o caminho PHP correto no servidor; versões EasyApache podem usar outro binário absoluto. Nunca dependa do diretório atual.

Criar no cPanel

1. Abra Advanced > Cron Jobs.
2. Cadastre um e-mail de notificação durante os testes.
3. Escolha intervalo com folga para a execução anterior terminar.
4. Informe comando com caminhos absolutos.
5. Salve e aguarde o próximo ciclo.
6. Confira e-mail e arquivo de log.

Checklist de falha

• execute o comando por SSH;
• confirme usuário, arquivo e permissão;
• verifique shebang e final de linha;
• carregue variáveis de ambiente explicitamente;
• use versão PHP correta e extensões;
• confira timezone do cron/aplicação;
• evite URL HTTP quando pode executar CLI.

Sobreposição

Se uma tarefa dura 10 minutos e roda a cada minuto, haverá concorrência. Use lock oferecido pelo framework ou flock quando disponível. Defina timeout e comportamento para falhas; não use killall genérico.

Notificações

Redirecionar para /dev/null 2>&1 esconde toda saída. Faça isso apenas depois de estabilizar e mantenha log/monitoramento adequado. Rotacione logs para não esgotar a quota.

Evite cron por URL pública

Chamadas com curl https://site/tarefa dependem de DNS, webserver e timeout e podem expor uma rotina administrativa. Prefira comando CLI. Quando a aplicação exige HTTP, use token rotativo, HTTPS, restrição de origem, timeout e resposta idempotente; nunca coloque segredo visível no histórico ou log.

Mantenha uma descrição da finalidade ao lado de cada agendamento.

Referência: Cron Jobs no cPanel.

Novos guias relacionados

Aprofunde o diagnóstico com estes conteúdos atualizados:

• cPanel sem espaço: Disk Quota Exceeded, inodes e limite de arquivos — diagnóstico e limpeza
• Logs e métricas no cPanel: como encontrar erros, acessos, consumo e causa de indisponibilidade
• Como criar um Cron Job no cPanel: sintaxe, frequência, logs e execução segura
• Limite de recursos e erro 508 no cPanel: CPU, memória, I/O, processos e como corrigir

Recursos relacionados

Continue com materiais e serviços relacionados ao tema deste guia.