Ligar o modo de depuração do WordPress com segurança: WP_DEBUG e o registo

A resposta curta: quando o site mostra uma página branca ou «erro crítico» sem dizer porquê, o modo de depuração faz o WordPress escrever o erro num ficheiro. 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 registar avisos e erros.
define( 'WP_DEBUG_LOG', true ); Escreve-os no ficheiro wp-content/debug.log.
define( 'WP_DEBUG_DISPLAY', false ); Não os mostra no ecrã, 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 ficheiro tira o site do ar.
2 Abra o wp-config.php (Gestor de Ficheiros 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 ficheiro wp-content/debug.log: a última linha costuma dizer o ficheiro 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 registo do PHP do servidor é outro, e complementa-o: O registo de erros do PHP.
5 Desligue tudo no fim: volte a false, e apague o debug.log.
O ficheiro debug.log é público por omissã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: desligue o modo quando acabar, apague o ficheiro 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 registo 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: ecrã branco, erro crítico e como achar a causa

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

Aumentar a memória disponível ao WordPress

Recriar a ligação do wp-config.php

PRODUTO RECOMENDADO

Alojamento WordPress

Instalação num clique, actualizações tratadas e velocidade a sério. desde 321,75 MT/mês (plano de 3 anos, com cupão)

Ver planos
  • 0 Utilizadores acharam útil
Esta resposta foi útil?

Artigos Relacionados

Como instalar o WordPress em poucos cliques Não precisa de descarregar o WordPress, criar uma base de dados e enviar ficheiros à mão. O instalador do cPanel faz tud...
Erros comuns do WordPress: ecrã branco, erro crítico e como achar a causa O site deixou de abrir e mostra um ecrã branco, ou a linha «Ocorreu um erro crítico neste site». São duas caras do mesmo...
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...
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...
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...
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 (Definições > Geral, «Qualquer pessoa pode reg...