Como Depurar Erro de Script PHP Executado por Cron (GUIA PRÁTICO PARA CLIENTES LEIGOS)
Olá, querido(a) cliente! Se você está aqui, é porque um script PHP que roda automaticamente via Cron parou de funcionar — e talvez nem saiba por quê. Não se preocupe. Como seu Sensei da GeHost, vou te guiar com calma, passo a passo, como se fosse um amigo explicando ao lado do computador. Vamos juntos!
Dica do Sensei: Cron é como um despertador automático no seu servidor. Ele executa tarefas programadas — como enviar emails, limpar arquivos antigos ou atualizar dados. Quando algo dá errado, o erro pode não aparecer na tela, mas está lá, escondido nos logs.
Passo 1: Acesse o cPanel (seu painel de controle)
Primeiro, faça login no cPanel da sua conta GeHost. Use o link que você recebeu por e-mail ou acesse diretamente pelo nosso site.
Passo 2: Encontre o Cron Jobs (Tarefas Agendadas)
No cPanel, procure pela seção “Cron Jobs”. Ela está no grupo “Advanced”, geralmente ao lado de “Softaculous” ou “Backup”. Clique nela.
Passo 3: Localize o Script que Está com Problema
Na tela de Cron Jobs, você verá uma lista de tarefas agendadas. Procure pelo comando que executa o seu script PHP. Ele geralmente terá um formato assim:
php /home/usuario/public_html/meuscript.phpSe você não souber qual é, olhe o nome do arquivo ou o que ele faz (ex: “enviar_emails.php”, “limpar_cache.php”).
Passo 4: Verifique o E-mail de Saída (Log do Cron)
Quando um script Cron falha, o sistema envia uma mensagem de erro para o e-mail associado à sua conta. Esse é o primeiro lugar onde você deve procurar!
- Abra o Webmail (acesso via cPanel ou diretamente em webmail.gehost.com.br).
- Entre com suas credenciais.
- Verifique a caixa de entrada, especialmente mensagens do sistema com assunto como “Cron Job Output” ou “Failed to execute”.
Passo 5: Leia o Erro com Calma
Abra a mensagem de erro. Ela pode dizer algo como:
- Parse error: syntax error, unexpected '}' in /home/usuario/public_html/meuscript.php on line 42
- Warning: include(): failed to open stream: No such file or directory
- PHP Fatal error: Uncaught Error: Call to undefined function...
Esses erros são mensagens de ajuda! Elas indicam exatamente onde está o problema:
- Sintaxe errada? Um colchete fechado sem aberto, ponto e vírgula faltando.
- Arquivo ausente? O script tenta incluir um arquivo que não existe.
- Função não definida? O script usa uma função que não está disponível (ex: função do PHP desativada).
Passo 6: Acesse o Arquivo com o Gerenciador de Arquivos
Volte ao cPanel e vá até “Arquivos” → “Gerenciador de Arquivos”. Navegue até a pasta onde está o script PHP (geralmente public_html).
Localize o arquivo mencionado no erro (ex: meuscript.php). Clique nele e escolha “Editar”.
Passo 7: Corrija o Erro e Salve
Abra o arquivo no editor. Vá para a linha indicada no erro (ex: linha 42). Verifique:
- Se há um
;faltando. - Se os parênteses ou chaves estão fechados corretamente.
- Se o caminho de um arquivo incluído está certo (ex:
include 'config.php').
Corrija o problema, clique em “Salvar” e espere um minuto.
Passo 8: Teste o Script Manualmente
Para garantir que o erro foi resolvido:
- Abra o terminal (SSH) ou use o “Executar PHP” no cPanel (se disponível).
- Execute o comando do cron manualmente:
php /home/usuario/public_html/meuscript.phpSe aparecer uma mensagem de erro, revise novamente. Se não aparecer nada, o script está funcionando!
Passo 9: Reative o Cron (se necessário)
Se você desativou o cron para testar, volte ao painel de Cron Jobs e certifique-se de que a tarefa está ativa. O cron pode ter parado de rodar por causa de um erro anterior.
Passo 10: Monitore o Resultado
Depois de corrigir, espere o próximo ciclo do cron. Volte ao Webmail em 10 minutos e verifique se o erro ainda aparece. Se não aparecer, parabéns! Você venceu o bug!
Sensei diz: Erros são amigos. Eles te ensinam. Cada vez que você corrige um, fica mais forte. Não se desanime. A GeHost está aqui com você!
Se ainda tiver dúvidas, entre em contato com nosso suporte — e lembre-se: todo problema tem solução, e você já está no caminho certo.
