Como resolver erro 500 e 404 em sites PHP (guia completo)

19/12/2025 Alexandre

Como resolver erro 500 e 404 em sites PHP (guia completo)

Se ao acessar um site você já se deparou com mensagens como Erro 500 – Internal Server Error ou Erro 404 – Página não encontrada, saiba que esses são dois dos problemas mais comuns em sites PHP.

Neste guia completo, você vai entender o que causa esses erros, como identificar a origem e como corrigir passo a passo, mesmo em sites PHP puro.

O que é o erro 500 (Internal Server Error)

O erro 500 indica que o servidor encontrou um problema interno ao tentar processar a requisição. Em sites PHP, isso normalmente significa que algum script falhou, mas o servidor não conseguiu informar exatamente o motivo ao navegador.

Diferente de outros erros, o 500 não aponta diretamente a causa, o que torna o diagnóstico fundamental.

Principais causas do erro 500 em PHP

Erro de sintaxe no PHP

Um simples ponto e vírgula faltando, uma função inexistente ou um include incorreto pode gerar erro 500.

Permissões incorretas de arquivos ou pastas

Permissões erradas impedem o servidor de executar scripts PHP corretamente.

Pastas: 755
Arquivos: 644

Arquivo .htaccess com erro

Uma regra mal escrita no arquivo .htaccess pode derrubar todo o site.

Funções desativadas no servidor

Hospedagens compartilhadas costumam bloquear funções como exec, shell_exec ou ini_set.

Estouro de memória ou timeout

Scripts muito pesados podem exceder os limites configurados no servidor.

Como identificar a causa do erro 500 corretamente

Ativar exibição de erros no PHP

Use temporariamente no início do script:

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

Atenção: nunca deixe essa configuração ativa em produção.

Verificar os logs do servidor

Os logs mostram exatamente o que está quebrando.

Apache: /var/log/apache2/error.log
Hospedagem compartilhada: disponível no painel (cPanel, Plesk, etc.)

Testar com um script PHP simples

Crie um arquivo teste.php:




Se nem isso funcionar, o problema está no servidor ou na configuração.


Como corrigir o erro 500 em sites PHP (passo a passo)


  Remova temporariamente o arquivo .htaccess
  Revise o último arquivo alterado
  Confira permissões de arquivos e pastas
  Confirme a versão do PHP no servidor
  Leia o log com atenção para identificar o arquivo e a linha do erro


chmod 755 pasta
chmod 644 arquivo.php

O que é o erro 404 (Página não encontrada)


O erro 404 acontece quando o servidor está funcionando corretamente,
mas o arquivo ou rota solicitada não existe.



Ele é comum em URLs digitadas incorretamente, links quebrados ou rotas mal configuradas.


Principais causas do erro 404 em sites PHP

Caminho do arquivo incorreto


Em servidores Linux, diferença entre letras maiúsculas e minúsculas importa:


/Pagina.php
/pagina.php

URLs amigáveis mal configuradas

O RewriteEngine pode não estar funcionando corretamente.


Arquivo inexistente no servidor

O link aponta para um recurso que nunca foi criado ou foi removido.


Como resolver erro 404 em sites PHP

Conferir se o arquivo realmente existe


Teste acessando diretamente:


https://site.com.br/arquivo.php

Configurar corretamente o .htaccess

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [L]

Verificar caminhos relativos e absolutos


Prefira caminhos absolutos:


require $_SERVER['DOCUMENT_ROOT'] . '/config.php';

Diferença entre erro 500 e erro 404


  
    Erro
    Significado
  
  
    500
    Erro interno no servidor
  
  
    404
    Página ou recurso não encontrado
  


Como evitar erros 500 e 404 no futuro


  Manter logs ativos
  Testar alterações antes de subir para produção
  Usar controle de versão
  Monitorar erros do servidor
  Padronizar rotas e includes


Se o problema for acesso negado, veja também como resolver o erro 403 Forbidden em PHP.


Erro 403 Forbidden em sites PHP: o que é e como resolver


Conclusão


Os erros 500 e 404 são comuns em sites PHP, mas raramente são problemas graves
quando diagnosticados corretamente.



Com acesso aos logs, boas práticas de configuração e atenção aos detalhes,
é possível resolver esses erros rapidamente e evitar que eles se repitam,
garantindo estabilidade e uma boa experiência para o usuário.

Erro	Significado
500	Erro interno no servidor
404	Página ou recurso não encontrado