Configurador de WP_DEBUG

Ative o log de depuração sem quebrar seu site no ar

Roda no seu navegador. Nada é enviado.

Onde está este site?

Isto muda a recomendação, não apenas a redação. A configuração segura em um site no ar é genuinamente diferente da configuração útil no seu computador.

Site em produção Local / homologação

Veredito

—

Opções

WP_DEBUG — ativar a depuraçãoFaz o WordPress relatar avisos (notices), advertências (warnings) e recursos obsoletos do PHP que ele normalmente engoliria. WP_DEBUG_LOG — gravar em um arquivoOs erros vão para wp-content/debug.log em vez da tela. É esta constante que torna seguro depurar em um site em produção. WP_DEBUG_DISPLAY false — ocultar os erros dos visitantesSem isto, o WP_DEBUG imprime os erros do PHP nas suas páginas. Desativá-lo é a linha mais importante desta página. Gravar o log fora da raiz do siteEm muitas hospedagens, wp-content/debug.log é público — qualquer um pode baixá-lo. Movê-lo acima da raiz do site resolve isso. Ajuste o caminho conforme o seu servidor. SAVEQUERIES — registrar todas as consultas ao banco de dadosÚtil para investigar uma página lenta. Consome memória em CADA requisição, então desative depois. SCRIPT_DEBUG — carregar o JS/CSS do core sem minificaçãoSó é útil se você estiver depurando o editor de blocos ou os scripts do core.

wp-config.php

Cole estes ACIMA da linha que diz /* That's all, stop editing! */ — qualquer coisa abaixo dela é ignorada, e é por isso que tanta gente relata que o WP_DEBUG "não faz nada".

Sobre o Configurador de WP_DEBUG

Gere as constantes WP_DEBUG que gravam os erros em um arquivo de log em vez de exibi-los para seus visitantes. O trecho padrão de WP_DEBUG que a maioria dos sites copia exibe os erros do PHP publicamente — este não faz isso.

Relacionados

Outras ferramentas que você pode precisar

Decodificador de erro fatal do PHP no WordPress

Cole o erro. A gente diz qual é o plugin.

Gerador de wp-config.php

Monte um wp-config.php correto sem copiar e colar de um post de blog de 2014

Perguntas frequentes

Perguntas

É seguro habilitar o WP_DEBUG em um site no ar?

Só com o WP_DEBUG_DISPLAY definido como false. Sozinho, o WP_DEBUG imprime avisos e alertas do PHP — incluindo os caminhos absolutos de arquivo do seu servidor — direto nas páginas que seus visitantes carregam. Quase todo tutorial te entrega aquela única linha e para por aí. Combine-a com o WP_DEBUG_LOG e o WP_DEBUG_DISPLAY como false e ela fica segura.

Onde vai parar o log de debug do WordPress?

Em wp-content/debug.log por padrão. Vale saber: em muitas hospedagens esse arquivo é acessível publicamente — qualquer um pode requisitá-lo em um navegador. Você pode passar um caminho para o WP_DEBUG_LOG e escrever o log acima da raiz web, o que esta ferramenta vai gerar pra você.

Defini o WP_DEBUG como true e nada aconteceu. Por quê?

Quase sempre porque a constante foi adicionada ABAIXO da linha que diz "That's all, stop editing!" no wp-config.php. Tudo depois dessa linha é ignorado. Mova-a para cima.