Ativar o modo de depuração do WordPress com segurança: WP_DEBUG e o registro

WordPress e CMS·· 146 visualizações· 3 min de leitura

A resposta curta: quando o site mostra uma página branca ou «erro crítico» sem dizer por quê, o modo de depuração faz o WordPress escrever o erro num arquivo. Liga-se com três linhas no wp-config.php. Mas tem uma regra: desligue-o quando acabar, e não deixe os erros à vista dos visitantes.

As três linhas

Linha O que faz
define( 'WP_DEBUG', true ); Liga o modo de depuração: o WordPress passa a registrar avisos e erros.
define( 'WP_DEBUG_LOG', true ); Escreve-os no arquivo wp-content/debug.log.
define( 'WP_DEBUG_DISPLAY', false ); Não os mostra na tela, para os visitantes não os verem.

Passo a passo

1 Faça uma cópia do wp-config.php. Um erro de escrita neste arquivo tira o site do ar.
2 Abra o wp-config.php (Gerenciador de Arquivos do cPanel) e procure a linha que diz «WP_DEBUG». Se existe com o valor false, troque-a pelas três linhas acima; se não existe, ponha as três antes da linha «That’s all, stop editing».
3 Repita o problema (abra a página que falha) e depois abra o arquivo wp-content/debug.log: a última linha costuma dizer o arquivo e o plugin ou tema em causa.
4 Leia o erro e atue: Erros comuns do WordPress, e se for de memória, dar mais memória. O registro do PHP do servidor é outro, e complementa-o: O registro de erros do PHP.
5 Desligue tudo no fim: volte a false, e apague o debug.log.
O arquivo debug.log é público por padrão: quem souber o endereço (o-seu-dominio.com/wp-content/debug.log) pode lê-lo, e ele mostra caminhos e nomes de plugins. Por isso: desative o modo quando acabar, apague o arquivo e, se tem de o deixar ligado, proteja-o. Nunca deixe o WP_DEBUG_DISPLAY a verdadeiro num site com visitantes.
Se o site nem abre por causa do erro, desative os plugins primeiro: Desativar plugins, mesmo sem conseguir entrar.

O registro não ajuda e continua sem perceber? Abra um pedido com as últimas linhas do debug.log (sem senhas).

Abrir pedido de suporte

VEJA TAMBÉM

Erros comuns do WordPress: tela branca, erro crítico e como achar a causa

Onde está o registro de erros do PHP, como o ler, e os erros que mais aparecem

Aumentar a memória disponível ao WordPress

Recriar o link do wp-config.php

PRODUTO RECOMENDADO

Alojamento WordPress

Instalação num clique, actualizações tratadas e velocidade a sério. desde R$ 36,30/mês (plano de 3 anos, com cupom)

Ver planos
Esta resposta foi útil? Sua resposta nos ajuda a melhorar este artigo.

Artigos Relacionados

WordPress e CMS 1.445 Como instalar o WordPress em poucos cliques Não precisa de baixar o WordPress, criar um banco de dados e enviar arquivos à mão. O instalador do cPanel faz tudo isso...
WordPress e CMS 1.293 Erros comuns do WordPress: tela branca, erro crítico e como achar a causa O site deixou de abrir e mostra uma tela branca, ou a linha «Ocorreu um erro crítico neste site». São duas caras do mesm...
WordPress e CMS 817 Não consigo entrar no painel do WordPress: as seis causas habituais O site abre, mas o painel de administração não. Ou pede a senha em ciclo sem fim, ou diz que os dados estão errados quan...
WordPress e CMS 789 Como remover o WordPress de um domínio, sem deixar restos Quer o WordPress fora de um domínio, porque a instalação partiu, porque vai começar de novo, ou porque o site vai passar...
WordPress e CMS 1.168 Proteger a entrada do WordPress: três passos por ordem de efeito O endereço de entrada do WordPress é o mesmo em todos os sites do mundo: /wp-admin e /wp-login.php. Isso quer dizer que...
WordPress e CMS 58 Deixar os visitantes registarem-se no seu WordPress: papéis, robôs e riscos A resposta curta: o WordPress pode deixar qualquer pessoa criar uma conta (Configurações > Geral, «Qualquer pessoa pode...