Como usar o log de erros do PHP para descobrir por que uma página específica quebra

Como usar o log de erros do PHP para descobrir por que uma página específica quebra

Olá, querido(a) cliente da GeHost! Se você está aqui, provavelmente já se deparou com uma página que simplesmente não carrega — ou exibe uma mensagem como "Erro 500" ou "Erro interno do servidor". Não se preocupe: isso é mais comum do que parece, e o log de erros do PHP é o seu melhor aliado para descobrir o que está errado.

Como seu Sensei da GeHost, vou te guiar passo a passo com paciência e clareza. Vamos juntos resolver isso, como um verdadeiro time de hackers do bem. 🛠️

Por que o log de erros do PHP é tão importante?

Quando uma página quebra, o servidor muitas vezes não mostra a causa exata — só diz "erro". Mas o log de erros do PHP guarda todas as pistas: um código mal escrito, um arquivo ausente, uma função desatualizada… Tudo isso aparece ali, como um diário secreto do seu site.

💡 Dica do Sensei: Sempre mantenha o log de erros ativado em ambiente de desenvolvimento. Isso evita surpresas no futuro!

Passo a passo: como acessar e ler o log de erros do PHP

1. Entre no painel da GeHost

   Abra o navegador e acesse: painel.gehost.com.br. Faça login com seu usuário e senha.

   

2. Encontre o Gerenciador de Arquivos

   No painel, procure pela ferramenta chamada Gerenciador de Arquivos (File Manager). Ela está na seção "Arquivos". Clique nela.

   

3. Navegue até a pasta do seu site

   Dentro do Gerenciador de Arquivos, vá até a pasta chamada public_html (ou o nome da sua pasta principal, se você usou um subdomínio ou subpasta).

   É aqui que estão todos os arquivos do seu site. Procure pela página que está quebrando — por exemplo, index.php ou contato.php.

4. Localize o arquivo de log de erros

   Em geral, o log de erros do PHP está em um arquivo chamado error_log ou php_error.log. Ele pode estar na pasta public_html ou em uma subpasta como logs/.

   Se você não encontrar o arquivo, ele pode estar desativado. Vamos ver como ativar isso.

5. Ative o log de erros (se necessário)

   Se o arquivo error_log não existe, é porque o log está desativado. Para ativar, você precisa editar um arquivo chamado .htaccess na pasta public_html.

   Use o Gerenciador de Arquivos para abrir o arquivo .htaccess (se não aparecer, clique no botão "Mostrar arquivos ocultos" no canto superior direito).

   Adicione estas linhas no final do arquivo:

   php_value log_errors On
   php_value error_log /home/SEU_USUARIO/logs/php_error.log
       

   Substitua SEU_USUARIO pelo nome da sua conta no cPanel (você pode ver isso no painel).

   Salve o arquivo. Agora, o log será gerado automaticamente.

6. Abra o log de erros

   Volte ao Gerenciador de Arquivos e procure pelo arquivo php_error.log (ou error_log).

   Clique nele com o botão direito e escolha "Editar" ou "Visualizar".

   Veja a lista de erros. Eles aparecem em ordem cronológica, com data e hora.

7. Interprete os erros

   Olhe para os últimos erros, especialmente os que aparecem logo após tentar acessar a página quebrada. Exemplos comuns:

   • Parse error: syntax error, unexpected '}' in /home/usuario/public_html/index.php on line 42 → Tem um colchete fechado sem abertura.
   • Warning: include(inc/header.php): failed to open stream: No such file or directory → Um arquivo referenciado não existe.
   • Fatal error: Uncaught Error: Call to undefined function → Uma função foi chamada, mas não foi definida.

   Esses erros são como pistas no jogo de detetive. Com eles, você sabe exatamente onde procurar.

Quando pedir ajuda ao suporte da GeHost

Se você não conseguir entender o erro, ou se ele for muito técnico, é só nos mandar o conteúdo do log de erros. Basta copiar os últimos 5-10 linhas e nos enviar pelo suporte da GeHost.

Quando pedir ajuda, diga:

“Estou com um erro em uma página. O log de erros do PHP mostra: [cole o texto aqui].”

Isso nos ajuda a te ajudar rápido e com precisão. 🙌

Curiosidade do Sensei

Todo grande desenvolvedor já passou por um erro que parecia impossível de resolver. O segredo? Não desistir. O log de erros é o seu espelho. Ele mostra exatamente o que o seu código está dizendo — mesmo quando você não entende.

Se hoje você aprendeu algo novo, já está um passo à frente. E isso é o que importa.

Com carinho, seu Sensei da GeHost 🌿
*Grupo: G e Soluções e Eventos LTDA (marca institucional Entexp, entexp.com.br). Dono: Raphael Neves Koga (desde 2015).*