Como Interpretar os Logs de Erro do Site (error_log) para Achar a Causa de um Bug
Olá, querido(a) cliente da GeHost! 👋
Seu site está com algum problema? Uma página que não carrega, um formulário que não envia, ou até um erro estranho aparecendo na tela? Antes de pular para o suporte, talvez você possa descobrir a causa sozinho(a) — e com um pouco de paciência e orientação, isso é totalmente possível.
Hoje, vou te ensinar como abrir e interpretar o error_log — um arquivo mágico que grava todos os erros do seu site, como um diário de bordo do seu servidor. É como ter um "detetive interno" para encontrar bugs. Vamos lá, com calma e certeza!
Passo 1: Acesse o Gerenciador de Arquivos do cPanel
Primeiro, faça login no seu cPanel — o painel de controle da sua hospedagem.
Depois de logado, procure pela ferramenta chamada Gerenciador de Arquivos. Ela está na seção "Arquivos".
Passo 2: Encontre a Pasta do Seu Site
No Gerenciador de Arquivos, você verá uma árvore de pastas. O local principal do seu site é geralmente a pasta chamada public_html (ou o nome do seu domínio, se estiver em um subdomínio).
Abra essa pasta. Dentro dela, procure por um arquivo chamado error_log. Ele pode estar na raiz ou em uma subpasta, dependendo da estrutura do seu site.
Passo 3: Abra o error_log com Cuidado
Clique duas vezes no arquivo error_log para abri-lo. Ele pode estar vazio no início — isso é normal!
Se o erro já aconteceu, ele aparecerá ali com uma data, um tipo de erro (como "PHP Warning" ou "Fatal Error") e uma mensagem explicando o que deu errado.
Exemplo de erro comum:
PHP Fatal error: Uncaught Error: Call to undefined function my_custom_function() in /home/usuario/public_html/index.php on line 42
Isso quer dizer: "Você tentou usar uma função que não existe no seu código. Provavelmente esqueceu de incluir um arquivo ou digitou errado."
Passo 4: Entenda o que o erro está dizendo
Os erros geralmente seguem um padrão:
- PHP Fatal error → Erro grave que para o script.
- PHP Warning → Aviso, não para o site, mas algo está errado.
- PHP Notice → Informação pequena, como variável não definida.
- File not found → Arquivo ausente.
- Permission denied → Permissão negada para acessar um arquivo ou pasta.
Se o erro falar de um arquivo, como index.php ou config.php, abra esse arquivo com o editor do cPanel e veja a linha mencionada.
Passo 5: Dicas para Resolver o Erro
- Erro de função não definida? → Verifique se você incluiu o arquivo que contém essa função.
- Erro de conexão com banco de dados? → Confira os dados de conexão no arquivo de configuração (geralmente config.php ou wp-config.php).
- Erro de permissão? → O arquivo ou pasta pode estar com permissão incorreta. Clique com o botão direito no arquivo e use "Alterar Permissões" (normalmente 644 para arquivos, 755 para pastas).
- Erro de sintaxe PHP? → Um colchete, ponto e vírgula ou parêntese errado pode causar isso. Use um editor de código com destaque de sintaxe para ajudar.
Passo 6: Limpe o error_log (opcional, mas útil)
Quando você resolver o erro, pode ser bom limpar o log para não se confundir com erros antigos.
Abra o error_log, selecione todo o conteúdo e apague. Salve o arquivo. Pronto! O log estará vazio novamente.
Dica Final do Sensei da GeHost
👉 Lembre-se: O error_log é seu aliado. Ele não joga culpa, só mostra o que aconteceu. Às vezes, o erro não está no seu código, mas em um plugin, tema ou configuração do servidor. Se não conseguir resolver, envie o erro completo para o nosso suporte — com o texto exato do erro, e não só uma foto. Assim, ajudamos mais rápido!
Está com dúvidas? Quer um passo a passo com imagens reais do seu caso? É só nos chamar. Estamos aqui para te ajudar com carinho e atenção. 💚