O que é e como ativar o WordPress Debug Mode

Mesmo um site bem cuidado, que passa por ma­nu­ten­ções regulares, está sujeito a erros e falhas oca­si­o­nais. Es­pe­ci­al­mente aqueles que têm variados plugins ins­ta­la­dos podem enfrentar problemas de quando em quando, que requerem análise imediata e me­ti­cu­losa. Ative o WordPress Debug Mode, para iden­ti­fi­car erros com rapidez.

O que é WordPress Debug Mode?

Via de regra, erros em sites devem ser cor­ri­gi­dos o mais ra­pi­da­mente possível, sejam eles pequenas falhas, páginas do WordPress em branco ou erros no banco de dados do WordPress. Ao executar um debug no seu WordPress, você não precisará verificar cada um dos plugins ins­ta­la­dos para encontrar o problema (processo bastante demorado e que, em muitos casos, não resolve nada). Para uma resolução de problemas mais eficaz, faça uso do WordPress Debug Mode. Quando este modo é ativado, mensagens de erro são exibidas nas páginas afetadas, per­mi­tindo que você encontre o problema com fa­ci­li­dade, e o resolva di­re­ta­mente na fonte. Com ele, também é possível verificar se páginas estão fun­ci­o­nando per­fei­ta­mente, não pre­ci­sando, assim, de qualquer correção.

O WordPress Debug Mode é uma im­por­tante fer­ra­menta de análise que, além de revelar falhas no seu site, mostra os locais que já estão per­fei­ta­mente con­fi­gu­ra­dos. Ao encontrar erros no PHP, o debug do WordPress exibe avisos na parte superior na página, mesmo que estes (ainda) não estejam pre­ju­di­cando o de­sem­pe­nho do site.

Assim que tiver resolvido o problema, desative o WordPress Debug Mode. Este passo é im­por­tante, pois se você deixar o modo ativado, seu código PHP pode acabar ficando visível aos vi­si­tan­tes, o que é um grande risco de segurança. Sem contar que a ativação do WordPress Debug Mode afeta, um pouco, o de­sem­pe­nho dos sites.

O WordPress Debug Mode faz re­la­tó­rios?

Sim, o WordPress Debug Mode faz re­la­tó­rios op­ci­o­nal­mente. Quando executado, um debug simples exibe, de imediato, todos os erros en­con­tra­dos, mas não gera nenhum tipo de do­cu­men­ta­ção. Porém, problemas fre­quen­tes ou que ne­ces­si­tam da ação de terceiros podem ser mais bem es­cla­re­ci­dos por do­cu­men­ta­ções mi­nu­ci­o­sas. Ative o WordPress Debug Mode no seu servidor e defina a constante WP_DEBUG_LOG como true, para que a fer­ra­menta registre todas as mensagens de erro em um arquivo, de nome wp-content/debug.log. Nele, você poderá consultar as mensagens sempre que quiser.

WordPress Debug manual

Você pode ativar o WordPress Debug Mode de di­fe­ren­tes maneiras, sendo o caminho mais direto, o que passa pelo arquivo wp-config.php, lo­ca­li­zado no diretório principal do site. Conecte-se ao seu servidor por FTP e faça as al­te­ra­ções ne­ces­sá­rias no arquivo. Os passos abaixo explicam:

1. Por segurança, pri­mei­ra­mente faça um backup do seu site WordPress
2. Abra o arquivo wp-config.php no seu editor
3. Role para baixo até encontrar a linha define('WP_DEBUG', false);
4. Altere a linha para define('WP_DEBUG', true)
5. Caso a linha não exista, adicione-a você mesmo. Posicione-a logo acima do co­men­tá­rio /*That’s all, stop editing! Happy blogging.*/
6. Por último, salve suas al­te­ra­ções na parte superior da tela

Ao realizar esse pro­ce­di­mento, você ativa o WordPress Debug Mode. Fi­na­li­zada a ve­ri­fi­ca­ção, é fácil desativar modo: basta desfazer as al­te­ra­ções no arquivo. Ou seja, você deve abrir novamente o arquivo, rolar até a linha men­ci­o­nada acima e voltar com o valor false, an­te­ri­or­mente subs­ti­tuído por true. Assim que você salvar as al­te­ra­ções, o WordPress Debug Mode será encerrado. Repita esses passos quantas vezes quiser, sempre que precisar analisar o seu site em busca de erros.

Do­cu­men­ta­ção do WordPress Debug Mode

Como já ex­pli­ca­mos, o WordPress Debug Mode pode do­cu­men­tar mi­nu­ci­o­sa­mente os erros en­con­tra­dos, se assim for desejado. O pro­ce­di­mento também deve ser executado no arquivo wp-config.php. Para habilitar os re­la­tó­rios, embaixo da linha define('WP_DEBUG', true);, adicione uma nova linha, com o seguinte conteúdo: define('WP_DEBUG_LOG', true);. A partir de então, todas as mensagens de erro passam a ser re­gis­tra­das em um arquivo LOG, podendo ser ana­li­sa­das sempre que ne­ces­sá­rio. Com a linha adicional define('WP_DEBUG_DISPLAY', true); ou define('WP_DEBUG_DISPLAY', false);, que também pode ser inserida logo abaixo, você determina como as mensagens do debug devem ser exibidas: caso você as deseje por HTML, use true. Caso contrário, use false. Em todo caso, ambas as linhas não são obri­ga­tó­rias para a execução do WordPress Debug Mode.

Plugins para debug no WordPress

Você também pode executar um debug no seu site com a ajuda de plugins WordPress. A extensão gratuita WP Debugging, por exemplo, é bastante popular. Após instalado, este plugin ativa o WordPress Debug Mode e salva suas des­co­ber­tas em um arquivo de relatório. Ao desativar o plugin, modo debug se encerrará au­to­ma­ti­ca­mente.

Al­ter­na­ti­va­mente (ou com­ple­men­tar­mente), faça uso do plugin Query Monitor. A extensão, também gratuita, faz debug de consultas a bancos de dados, de erros de PHP e de outros problemas oriundos de fer­ra­men­tas ou plugins. Re­la­ti­va­mente abran­gente, o Query Monitor fornece diversas es­ta­tís­ti­cas e in­for­ma­ções im­por­tan­tes.

Conclusão: o WordPress Debug Mode é eficaz e fácil de usar

Para analisar possíveis erros do seu site WordPress, ative o WordPress Debug Mode. A uti­li­za­ção deste recurso é re­la­ti­va­mente fácil. Mesmo sem co­nhe­ci­men­tos avançados, você con­se­guirá descobrir, com rapidez, a origem de certos problemas. Caso você não esteja seguro em executar um debug manual, pode também utilizar plugins gratuitos, que realizam a tarefa de forma au­to­má­tica e sa­tis­fa­tó­ria.