Como ler e interpretar o log de erros do PHP para debugar o site

🥋 Sensei explica: como ler o log de erros do PHP e descobrir o que está de errado no seu site

Oi! Aqui é a Sensei da GeHost 😊 Se o seu site deu uma tela branca, aquele aviso feio de "Erro 500" ou simplesmente parou de funcionar depois de instalar um plugin/tema novo, respira fundo: a resposta quase sempre está escrita, em detalhes, no log de erros do PHP. Ele é tipo um "diário de bordo" do seu site — toda vez que algo dá errado nos bastidores, o PHP anota ali o motivo, o arquivo e até a linha do problema.

Neste guia eu vou te ensinar, com calma e sem juridiquês técnico, a encontrar esse log, ler o que ele diz e entender se dá pra resolver sozinho ou se é hora de chamar a gente.

📍 Passo 1 — Onde encontrar o log de erros

Você tem duas portas de entrada bem tranquilas para chegar até o log. Escolha a que achar mais fácil:

Opção A: pelo cPanel (mais visual)

1. Acesse o cPanel da sua hospedagem (o link e os acessos ficam disponíveis no seu painel.gehost.com.br).
2. Na tela inicial, procure o grupo de ferramentas de Métricas (o mesmo lugar das estatísticas de visitantes do site).

3. Dentro de Métricas, procure a ferramenta de "Erros" (às vezes aparece como "Errors"). Ela mostra, de forma bem simples, as últimas linhas do log de erros do seu site — sem precisar mexer em nenhum arquivo.

Opção B: pelo Gerenciador de Arquivos (mais completo)

1. No cPanel, abra o Gerenciador de Arquivos.
2. Entre na pasta do seu site (geralmente public_html, ou a subpasta do domínio/subdomínio específico se for o caso).
3. Procure um arquivo chamado error_log. Ele pode estar na raiz da pasta do site.
4. Clique com o botão direito nele e escolha "Editar" ou "Visualizar" para ler o conteúdo.

💡 Dica da Sensei: se o arquivo error_log estiver muito grande (alguns sites acumulam meses de anotações), ele pode demorar pra abrir. Foque sempre nas últimas linhas do arquivo — é lá que está o erro mais recente, o que provavelmente é o que está te incomodando agora.

🔍 Passo 2 — Entendendo a "anatomia" de uma linha de erro

Uma linha de erro típica parece assustadora à primeira vista, mas ela sempre segue mais ou menos essa estrutura:

[Data e hora] Tipo do erro: Mensagem do erro in /caminho/do/arquivo.php on line 42

Vamos separar isso em pedaços que fazem sentido:

• Data e hora — quando o erro aconteceu. Serve pra você bater com o momento em que percebeu o problema (ex.: "ah, foi logo depois que eu salvei aquela alteração").
• Tipo do erro — o "nível de gravidade". Os mais comuns:
  • Notice / Deprecated — avisos leves, quase sempre não quebram o site. É o PHP "pigarreando".
  • Warning — um aviso mais sério, mas o site geralmente continua funcionando.
  • Fatal error / Parse error — este é o vilão: quando aparece um desses, o site (ou aquela página) realmente para de funcionar.
• Mensagem do erro — a explicação em si (em inglês, geralmente). Ex.: "Call to undefined function", "Cannot redeclare", "Allowed memory size exhausted".
• Caminho do arquivo + número da linha — o "endereço exato" do problema. Isso é ouro: te diz literalmente QUAL arquivo do seu site (tema, plugin, etc.) e QUAL linha causou a confusão.

🧩 Passo 3 — Os erros mais comuns, traduzidos pra você

Aqui vai um "dicionário rápido" dos erros que mais aparecem em sites de clientes. Se você reconhecer algum, já entende metade do problema:

• "Allowed memory size exhausted" → o site tentou usar mais memória do que o permitido no seu plano. Geralmente acontece quando um plugin pesado, ou muitos plugins juntos, exigem demais.
• "Call to undefined function" ou "Call to undefined method" → algum código está chamando uma função que não existe (comum depois de atualizar/desatualizar um plugin ou tema pela metade).
• "Cannot redeclare function" → algo foi duplicado, geralmente porque um arquivo foi enviado/instalado duas vezes.
• "Parse error: syntax error" → tem algo "escrito errado" em um arquivo PHP (uma vírgula ou chave faltando, por exemplo). Costuma acontecer logo depois de editar um arquivo manualmente.
• "Maximum execution time exceeded" → alguma tarefa demorou demais pra rodar (uma importação grande, por exemplo) e foi interrompida.

💡 Dica da Sensei: repare que erros do tipo Fatal error quase sempre citam o nome de um plugin ou tema no caminho do arquivo (ex.: /wp-content/plugins/nome-do-plugin/...). Isso é uma pista enorme: geralmente o problema começou logo depois que aquele plugin/tema foi instalado ou atualizado.

🛠️ Passo 4 — O que fazer com essa informação

1. Anote a última linha de erro do tipo Fatal/Parse — é ela que importa mais.
2. Pense no "antes e depois": o que você fez pouco antes daquele horário? Instalou algo, atualizou algo, editou um arquivo?
3. Se o erro apontar pra um plugin/tema específico, muitas vezes desativar (ou voltar a versão anterior) daquele item resolve na hora.
4. Se o erro for algo mais técnico (código do site, arquivo core, lógica de sistema) ou você não se sentir confortável mexendo, é melhor não arriscar sozinho — chame a gente e cole a linha de erro completa. Isso já adianta muito o nosso diagnóstico!

📩 Quando chamar o suporte

Se depois de ler o log você ainda não conseguiu resolver, sem problema nenhum — é exatamente pra isso que a gente está aqui. Abra um chamado com a linha de erro completa (copiada do log) e conte o que você estava fazendo quando o problema começou. Quanto mais detalhe, mais rápido a gente resolve.

E lembra: se o seu serviço foi entregue pela nossa equipe recentemente, você tem 30 dias de suporte grátis após a entrega — é só chamar. Fora esse período, dá uma olhada no seu plano em painel.gehost.com.br pra ver as opções de suporte disponíveis.

🥋 A Sensei sempre diz: log de erro não é vilão, é o seu melhor amigo na hora de descobrir o que aconteceu. Quanto mais você se acostuma a olhar ele, mais rápido identifica os probleminhas do dia a dia!