Articles

WordPress.org

Línguas: Português – Français – Italiano – বাংলা – (Adicione a sua língua)

WP_DEBUG é uma constante PHP (uma variável global permanente) que pode ser usada para activar o modo “debug” em todo o WordPress. Ela é assumida como falsa por padrão e é normalmente definida como verdadeira no arquivo wp-config.php nas cópias de desenvolvimento do WordPress.

Para informações sobre outras ferramentas de depuração incorporadas no WordPress veja Depuração no WordPress

Utilização

Ativar depuração.

>

define( 'WP_DEBUG', true );

Debugging de desativação

define( 'WP_DEBUG', false );
NOTA: Os valores verdadeiros e falsos no exemplo não são definidos em apóstrofos (‘) porque são valores booleanos. Se você definir WP_DEBUG como ‘false’ que será interpretado como verdadeiro porque é uma string e não um boolean.

WP_DEBUG_LOG e WP_DEBUG_DISPLAY

WP_DEBUG_LOG e WP_DEBUG_DISPLAY são constantes PHP adicionais que estendem WP_DEBUG, e também podem ser usadas para depurar o WordPress.

WP_DEBUG_LOG

WP_DEBUG_LOG é um companheiro do WP_DEBUG que faz com que todos os erros também sejam salvos em um arquivo de log de debug.log dentro do diretório /wp-content/. Isto é útil se você quiser rever todos os avisos mais tarde ou precisar visualizar os avisos gerados fora da tela (por exemplo, durante uma solicitação AJAX ou execução do wp-cron).

define( 'WP_DEBUG_LOG', true );

WP_DEBUG_DISPLAY

WP_DEBUG_DISPLAY é outro companheiro do WP_DEBUG que controla se as mensagens de depuração são mostradas dentro do HTML das páginas ou não. O padrão é ‘true’ que mostra erros e avisos à medida que são gerados. Definindo isto como falso irá esconder todos os erros. Isto deve ser usado em conjunto com WP_DEBUG_LOG para que os erros possam ser revistos mais tarde.

define( 'WP_DEBUG_DISPLAY', false );

História

A opção WP_DEBUG foi adicionada na versão 2.3.1.

A partir da versão 2.3.2 do WordPress, os erros do banco de dados são impressos somente se WP_DEBUG estiver configurado para true. Em versões anteriores, os erros do banco de dados eram sempre impressos. (Os erros do banco de dados são tratados pela classe wpdb e não são afetados pelas configurações de erro do PHP.)

Iniciar com a versão 2.5 do WordPress, definindo WP_DEBUG como verdadeiro também eleva o nível de relatório de erros para E_ALL e ativa avisos quando funções ou arquivos obsoletos são usados; caso contrário, o WordPress define o nível de relatório de erros para E_ALL ^ E_NOTICE ^ E_USER_NOTICE.