Wordpress

Ativar WP_DEBUG_LOG no WordPress: log de erros sem aparecer na tela

Tela branca ou fatal error no ar e a mensagem não pode aparecer pro visitante. O caminho é jogar tudo num arquivo: WP_DEBUG liga o relatório, WP_DEBUG_LOG grava e WP_DEBUG_DISPLAY corta a saída na tela.

As três linhas no wp-config.php

Elas ficam acima do comentário /* That's all, stop editing! */. Depois dessa linha o wp-settings.php já rodou, e a wp_debug_mode() não olha mais pras constantes. Não é superstição, é ordem de carregamento.

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

WP_DEBUG chama error_reporting( E_ALL ). WP_DEBUG_LOG em true aponta o error_log do PHP pra wp-content/debug.log. E WP_DEBUG_DISPLAY em false faz o próprio WordPress rodar ini_set( 'display_errors', 0 ) — você não precisa repetir isso à mão, como muito tutorial manda. Está tudo em wp-includes/load.php.

Onde cai o log e como acompanhar

O arquivo nasce na primeira notice. Eu deixo um tail aberto num terminal e reproduzo o erro no navegador, assim dá pra amarrar cada linha à requisição que gerou ela. Pra ligar sem abrir editor, o WP-CLI já ancora as constantes no lugar certo do arquivo:

cd /var/www/seusite/html
sudo -u www-data wp config set WP_DEBUG true --raw
sudo -u www-data wp config set WP_DEBUG_LOG true --raw
sudo -u www-data wp config set WP_DEBUG_DISPLAY false --raw

tail -f wp-content/debug.log

Tire o log de dentro do docroot

wp-content/debug.log responde por URL. Quem acertar o endereço lê caminho de servidor, prefixo de tabela e trecho de query. Desde o WordPress 5.1 a constante aceita um caminho em vez de true, então aponte pra fora da pasta pública:

define( 'WP_DEBUG_LOG', '/var/log/wordpress/meusite-debug.log' );

O usuário do PHP-FPM (normalmente www-data) precisa poder escrever nesse arquivo, senão o log some sem aviso. Terminado o diagnóstico, devolva WP_DEBUG pra false e apague o arquivo: com um plugin barulhento ele passa de 1 GB numa semana e enche o disco no pior horário possível.

Post Recentes

API do DeepSeek no PHP: a mesma chamada da OpenAI trocando URL e chave

A API do DeepSeek aceita o mesmo formato de chat da OpenAI: troque a URL base e a chave, ponha…

9 horas atrás

Migrar models do CodeIgniter 3 para o 4 sem perder campo no insert

Converta os models do CodeIgniter 3 para a classe Model do CI4 com table, allowedFields e returnType, sem perder campos…

23 horas atrás

Cores no theme.json: trocar a paleta do tema de blocos sem plugin

Coloque as cores da marca no seletor do editor de blocos pelo theme.json, use as variáveis CSS geradas e bloqueie…

2 dias atrás

static-content:deploy pt_BR: gerar o idioma certo no Magento 2

A loja voltou em inglês depois do deploy porque pub/static só tem en_US. Gere o pt_BR no tema certo e…

3 dias atrás

Cache type próprio no Magento 2: cache.xml, TagScope e cache:clean

Seu módulo guarda resposta de API e você quer uma linha só dele no Cache Management. Declare o tipo em…

3 dias atrás

json_decode retornando null: achar o erro com JSON_THROW_ON_ERROR

O json_decode devolveu null e o PHP não disse nada. Veja como usar json_last_error_msg e JSON_THROW_ON_ERROR pra descobrir o que…

4 dias atrás