Como Interpretar os Logs de Erro do Servidor (error_log) – Guia para Iniciantes
Olá, amigo(a) GeHost! Seja bem-vindo(a) ao seu novo guia de paz com o servidor. 🌿
Você já se deparou com uma mensagem como “Erro 500”, “Página não encontrada” ou “Erro interno do servidor” e ficou sem saber o que fazer? Não se preocupe — isso é mais comum do que parece. E a boa notícia é: os logs de erro do servidor (error_log) são como um diário do seu site. Eles contam exatamente o que deu errado, quando e por quê. Aqui, você vai aprender a ler esse diário com calma, sem medo, passo a passo. Vamos juntos, como um bom time de devs e amigas/es de confiança. ✨ ---Passo 1: Encontre o arquivo error_log no cPanel
Primeiro, faça login no seu cPanel — o painel de controle da sua hospedagem.
Depois de logado, você verá a tela principal do cPanel. Procure pela seção “Arquivos” (File Manager é o nome mais comum).
---
Passo 2: Acesse o Gerenciador de Arquivos (File Manager)
Clique em “Gerenciador de Arquivos” (File Manager). Ele abre uma nova janela com a estrutura de pastas do seu site.
Selecione a opção “public_html” no menu da esquerda — essa é a pasta principal do seu site, onde todos os arquivos do seu site estão armazenados.
---
Passo 3: Localize o arquivo error_log
Dentro da pasta public_html, procure por um arquivo chamado error_log. Ele pode estar escondido — então, ative a opção “Mostrar arquivos ocultos” (no canto superior direito do File Manager).
Se não encontrar o arquivo, é possível que ele esteja em uma subpasta como logs/ ou var/logs/. Mas na maioria dos casos, ele está diretamente em public_html.
Se ainda não aparecer, não se preocupe — isso pode acontecer se o site não tiver gerado erros recentemente. O arquivo é criado automaticamente quando algo dá errado.
---Passo 4: Abra o arquivo error_log
Quando encontrar o arquivo error_log, clique com o botão direito sobre ele e selecione “Editar”.
Um editor de texto aparecerá. Ele pode estar em inglês, mas não se assuste — vamos traduzir juntos o que está escrito.
---Passo 5: Entenda o que está escrito (interpretação simples)
Os logs de erro geralmente têm um formato assim:
[Wed Apr 03 10:23:45.123456 2025] [php7:warn] [pid 12345] [client 192.168.1.100:54321] PHP Warning: Cannot modify header information - headers already sent in /home/usuario/public_html/index.php on line 42
Vamos decifrar isso juntos, como se fosse um código secreto:
- [Wed Apr 03 10:23:45.123456 2025] — É a data e hora em que o erro aconteceu. Útil para saber quando o problema ocorreu.
- [php7:warn] — Indica que o erro é relacionado ao PHP (linguagem usada para criar sites dinâmicos) e é um aviso (não é um erro fatal).
- [client 192.168.1.100:54321] — O IP da pessoa que acessou o site (não é seu IP, é o do visitante).
- PHP Warning: Cannot modify header information - headers already sent — O erro em si: o PHP tentou enviar um cabeçalho (como redirecionamento) depois que a página já tinha começado a ser enviada.
- in /home/usuario/public_html/index.php on line 42 — Localização do problema: no arquivo
index.php, na linha 42.
💡 Dica do Sensei: Erros como “headers already sent” geralmente acontecem quando há espaços, linhas em branco ou echo antes de header() no código PHP. Basta remover esses espaços extras no início do arquivo.
Passo 6: Como resolver o erro?
Depois de identificar a linha e o tipo de erro, você pode:
- Verificar o arquivo mencionado (ex:
index.php) no File Manager. - Localizar a linha do erro (ex: linha 42).
- Verificar se há
echo,print, espaços ou linhas em branco antes da funçãoheader(). - Remover ou corrigir o problema.
- Salvar o arquivo e testar o site novamente.
Se você não entende código, não se preocupe — envie o trecho do erro (copie e cole aqui) para o nosso suporte. Nós vamos te ajudar a resolver com carinho. ❤️
---Passo 7: Dicas para prevenir erros no futuro
- Nunca deixe espaços ou linhas em branco antes do
<?phpno início de arquivos PHP. - Evite usar
echoouprintantes de redirecionamentos comheader(). - Use um editor de texto que mostre espaços em branco (como VS Code ou Sublime Text).
- Ative o modo de desenvolvedor em seu site durante testes.
📌 Curiosidade do Sensei: O arquivo error_log é como um diário do servidor. Ele só grava erros quando estão ativos. Se não houver erros, o arquivo pode estar vazio ou não existir — não é um problema!
Conclusão: Você está no caminho certo!
Interpretar logs de erro pode parecer assustador no começo, mas com um pouco de paciência e prática, você vai se tornar um verdadeiro detetive da web. 🕵️♂️
Lembre-se: você não está sozinho. A GeHost está aqui para te ajudar sempre que precisar. Se tiver dúvidas, basta entrar em contato com o nosso suporte — nós respondemos com amor, atenção e rapidez.
Até a próxima, com mais conhecimento e menos erros. 🌟
