Styleguide

Debugando erros no WordPress

Debugando erros no WordPress

 

O wordpress fornece uma série de variáveis que permitem a identificação de erros que estejam ocorrendo na plataforma, nesta série de recursos, temos o

WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY

 

WP_DEBUG

É uma constante do PHP (uma variável global permanente) que pode ser usado para disparar o modo de “depuração” ao longo WordPress. Por padrão esta contante é setada como false e geralmente é definida como true no arquivo wp-config.php em cópias de desenvolvimento do WordPress.

Para ativá-la basta acessar o arquivo  wp_config.php e alterá-la para true, conforme a imagem abaixo:

img_wp_debug_1

com ela ativa, ao acessar o local do seu site, caso hajam erros ou variáveis depreciadas, um warning() ou notice será disparado, veja na imagem abaixo:

img_wp_debug_2

Apartir disso, existem as informações referentes à linha e ao arquivo do qual os erros estão ocorrendo, permitindo que você corrija.

 

WP_DEBUG_LOG

WP_DEBUG_LOG é um complemento para WP_DEBUG que faz com que todos os erros registrados sejam salvos no arquivo debug.log dentro do diretório /wp-content/diretório. Isso é útil se você quiser rever todos os avisos mais tarde ou precisar verificar notificações geradas fora da tela (por exemplo, durante uma solicitação ou wp-cron prazo AJAX).

Para ativá-lo é preciso definí-lo como true, no wp-config.php

img_wp_debug_3

Assim que ativado, você pode acessar o diretório /wp-content/ e buscar pelo arquivo debug.log, uma lista com os logs (caso existam) será exibida.

img_wp_debug_4

com o arquivo de logs é possível identificar facilmente os problemas recorrentes em seu WordPress.

 

WP_DEBUG_DISPLAY

WP_DEBUG_DISPLAY é outro complemento para WP_DEBUG que controla se as mensagens de depuração são mostrados dentro de sua página HTML ou não. O padrão é true que mostra os erros, avisos e como eles são gerados. Configurando isso para false irá esconder todos os erros. Isto deve ser utilizado em conjunto com WP_DEBUG_LOG de modo que os erros possam ser revistos mais tarde, assim você não vê nada em sua página, mas mantém o controle em seu arquivo de logs.

img_wp_debug_5

Na imagem acima definimos o WP_DEBUG_DISPLAY como false, assim ao acessarmos a nossa página HTML  nenhum erro será apresentado, contudo, não descartamos estes erros, uma vez que nossa constante WP_DEBUG_LOG continua ativa os erros serão salvos no arquivo debug.log conforme apresentado no tutorial anterior.