Seu site mostra uma página vazia, ou a frase “Há um erro crítico no seu site.” Nos dois casos, o PHP escreveu em algum lugar uma mensagem precisa, que nomeia o arquivo em causa. Este guia mostra onde lê-la, como interpretá-la e qual passo corresponde a cada mensagem.
wp-config.php e recarregue a página com erro.PHP Fatal error do wp-content/debug.log: o caminho do arquivo nomeia o plugin ou o tema em causa.debug.log.Uma tela branca é quase sempre um erro fatal do PHP: um arquivo do site pediu algo impossível, e a execução parou antes de exibir qualquer coisa. Desde o WordPress 5.2, o WordPress intercepta esses erros: em vez de uma página vazia, ele exibe “Há um erro crítico no seu site.” e envia um e-mail para o endereço de administração do site.
A página continua totalmente branca em alguns casos: uma versão mais antiga do WordPress, um erro que acontece antes do carregamento desse mecanismo, a constante WP_DISABLE_FATAL_ERROR_HANDLER definida como true, ou um plugin de cache que serve uma página vazia gravada durante a falha. O método a seguir vale para todos esses casos.
Três passos podem esperar até você ler o erro: reinstalar o WordPress, excluir plugins, restaurar um backup antigo. Cada um pode apagar configurações ou dados recentes, enquanto a mensagem de erro em geral diz qual componente desativar, sem perder nada.
Quando o WordPress intercepta o erro, ele envia para o endereço de e-mail de administração do site uma mensagem com o assunto “[Nome do site] O seu site está experimentando um problema técnico”. Ela nomeia o plugin ou o tema em causa e contém um link que abre o painel em modo de restauração.
Conecte-se ao site por SFTP ou pelo gerenciador de arquivos da hospedagem, abra o wp-config.php na raiz e substitua a linha define( 'WP_DEBUG', false ); por estas quatro linhas:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );Elas ficam acima do comentário que fecha a parte editável do arquivo (/* Isto é tudo, pode parar de editar! :) */ em um WordPress instalado em português, pt_BR). Recarregue a página com erro e depois abra o wp-content/debug.log. WP_DEBUG_DISPLAY como false mantém as mensagens no arquivo, fora da página que seus visitantes veem.
Se o debug.log continuar vazio ou não aparecer, o erro foi registrado diretamente pelo PHP: procure um arquivo error_log na raiz do site ou em wp-admin, ou a seção de logs de erro no painel da hospedagem.
Um erro fatal cabe em uma linha: o tipo de erro, a descrição, depois in seguido do caminho completo do arquivo e do número da linha. O caminho é a informação mais útil: wp-content/plugins/nome/ indica um plugin, wp-content/themes/nome/ um tema.
| A mensagem contém | O que significa | O passo |
|---|---|---|
Call to undefined function ou Class "…" not found, em wp-content/plugins/nome-do-plugin/ | O plugin chama um código ausente: atualização incompleta, plugin do qual ele depende desativado, ou versão do PHP que ele não suporta. | Desativar esse plugin e depois reinstalá-lo ou atualizá-lo. |
Allowed memory size of 268435456 bytes exhausted | O script ultrapassou a memória reservada ao PHP, aqui 268.435.456 bytes, ou seja 256 MB. | Aumentar WP_MEMORY_LIMIT no wp-config.php, dentro do limite fixado pela hospedagem, e depois procurar o que consome tanto. |
PHP Parse error: syntax error, unexpected, em functions.php on line 42 | Um erro de sintaxe em um arquivo, muitas vezes depois de uma alteração feita à mão no editor de temas. | Corrigir a linha indicada, ou recolocar a versão anterior do arquivo. |
Uncaught TypeError ou Uncaught ArgumentCountError, depois de uma mudança de versão do PHP | Um componente escrito para uma versão mais antiga do PHP, que a versão atual se recusa a executar. | Atualizar o componente. Como solução temporária, voltar à versão anterior do PHP no painel da hospedagem, enquanto ele é substituído. |
Maximum execution time of 30 seconds exceeded | Um processamento ultrapassou a duração permitida pelo PHP (max_execution_time). | Identificar o processamento (importação, backup, geração de imagens) e aumentar o limite na hospedagem se esse processamento for legítimo. |
define( 'WP_MEMORY_LIMIT', '256M' );Renomeie a pasta do plugin citado na mensagem, por exemplo wp-content/plugins/nome-do-plugin para nome-do-plugin.off. O WordPress não encontra mais o plugin e para de carregá-lo; as configurações dele continuam gravadas no banco de dados, e o WordPress o desativa na próxima vez que a tela de plugins for aberta.
Para um tema, renomear a pasta dele em wp-content/themes torna o painel acessível de novo, mas os visitantes veem uma página vazia enquanto nenhum tema estiver ativo. Abra em seguida Aparência > Temas: o WordPress constata que o tema ativo está quebrado e volta para um tema padrão instalado.
wp plugin list --status=active
wp plugin deactivate nome-do-plugin
wp theme list
wp theme activate twentytwentyfiveO primeiro comando guarda a lista dos plugins ativos, útil antes de qualquer desativação em massa. Se o próprio WP-CLI parar no erro, acrescente --skip-plugins --skip-themes ao comando: ele então roda sem carregar os plugins nem o tema. Os plugins da pasta wp-content/mu-plugins são carregados mesmo assim; se o erro vier de um deles, renomeie o arquivo dele.
Quando a mensagem não indica nenhum componente, wp plugin deactivate --all desativa todos os plugins. Se o site voltar, reative-os um a um, recarregando o site entre cada um: o último reativado antes de o erro voltar é o responsável.
define( 'WP_DEBUG', false ); e retire WP_DEBUG_LOG do wp-config.php.wp-content/debug.log: guardado em uma pasta acessível pela web, ele pode ser lido por qualquer pessoa e contém caminhos do servidor.Com Serenity by Simafri, criamos seu site profissional, nós o hospedamos, protegemos e mantemos atualizado. Basta nos escrever, nós cuidamos de tudo. Nome de domínio e e-mail profissional incluídos.
Porque aconteceu um erro fatal do PHP, quase sempre em um plugin ou em um tema. O WordPress o intercepta, exibe essa mensagem e envia um e-mail para o endereço de administração do site, com um link para o modo de restauração. O log de depuração dá o detalhe do erro e o arquivo em causa.
Verifique a pasta de spam e o endereço de e-mail de administração informado em Configurações > Geral. Sem o e-mail, ative o log de depuração no wp-config.php, leia o erro em wp-content/debug.log e depois desative o componente em causa renomeando a pasta dele por SFTP.
As configurações dos plugins ficam gravadas no banco de dados, e não na pasta deles: elas continuam lá. Um plugin renomeado aparece desativado; recoloque o nome original da pasta e reative-o na tela de plugins para recuperá-lo com as configurações.
O componente com erro só é carregado no painel, ou a memória necessária ali é maior. O WordPress aplica WP_MAX_MEMORY_LIMIT às telas de administração e WP_MEMORY_LIMIT ao site público. O log de depuração dá a mesma informação nos dois casos: carregue a página de administração com erro e depois leia o debug.log.
Simafri
Vamos falar de seu site
Conte para a gente sobre seu projeto em poucas palavras: responderemos rapidamente.
Obrigado! O seu pedido foi enviado. Responderemos em breve.
Prefere o e-mail? Escreva para a gente em support@simafri.com.