# O que é e como ativar o WordPress Debug Mode

Mesmo um site bem cuidado, que passa por manutenções regulares, está sujeito a erros e falhas ocasionais. Especialmente aqueles que têm variados plugins instalados podem enfrentar problemas de quando em quando, que requerem **análise imediata e meticulosa**. Ative o WordPress Debug Mode, para **identificar erros com rapidez**.

## O que é WordPress Debug Mode?

Via de regra, erros em sites devem ser corrigidos o mais rapidamente possível, sejam eles pequenas falhas, [páginas do WordPress em branco](https://www.ionos.com/pt-br/digitalguide/hospedagem/cms/tela-branca-wordpress/) ou erros no banco de dados do WordPress. Ao executar um *debug* no seu WordPress, você não precisará **verificar cada um dos plugins** instalados 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**, permitindo que você encontre o problema com facilidade, e o resolva diretamente na fonte. Com ele, também é possível verificar se páginas estão funcionando perfeitamente, não precisando, assim, de qualquer correção.

O WordPress Debug Mode é uma **importante ferramenta de análise** que, além de revelar falhas no seu site, mostra os locais que já estão perfeitamente configurados. Ao encontrar erros no PHP, o *debug* do WordPress exibe avisos na parte superior na página, mesmo que estes (ainda) não estejam prejudicando o desempenho do site.

Assim que tiver resolvido o problema, desative o WordPress Debug Mode. Este passo é importante, pois se você deixar o modo ativado, seu código PHP pode acabar ficando visível aos visitantes, o que é um **grande risco de segurança**. Sem contar que a ativação do WordPress Debug Mode afeta, um pouco, o desempenho dos sites.

Dica O [Hospedagem para WordPress](https://www.ionos.com/hosting/wordpress-hosting "Hospedagem para WordPress da IONOS") da IONOS oferece uma série de vantagens decisivas. Proteja-se com os diversos recursos de segurança incluídos, e conte com suporte técnico 24 horas. Todos os planos disponíveis incluem, no mínimo, um domínio grátis.

## O WordPress Debug Mode faz relatórios?

Sim, o WordPress Debug Mode **faz relatórios opcionalmente**. Quando executado, um *debug* simples exibe, de imediato, todos os erros encontrados, mas não gera nenhum tipo de documentação. Porém, problemas frequentes ou que necessitam da ação de terceiros podem ser mais bem esclarecidos por **documentações minuciosas**. Ative o WordPress Debug Mode no seu servidor e defina a constante `WP_DEBUG_LOG` como `true`, para que a ferramenta 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

[![Imagem: Captura de tela de um debug manual no WordPress](https://www.ionos.com/pt-br/digitalguide/fileadmin/_processed_/1/7/csm_manueller-debug-bei-wordpress_5eb64a29a8.webp "Captura de tela de um debug manual no WordPress")](https://www.ionos.com/pt-br/digitalguide/fileadmin/DigitalGuide/Screenshots_2021/manueller-debug-bei-wordpress.png) Você pode realizar um debug manual no WordPress, no arquivo wp-config.php Você pode ativar o WordPress Debug Mode de diferentes maneiras, sendo o caminho mais direto, o que passa pelo arquivo `wp-config.php`, localizado no diretório principal do site. Conecte-se ao seu servidor por FTP e faça as alterações necessárias no arquivo. Os passos abaixo explicam:

1. Por segurança, primeiramente faça um [**backup do seu site WordPress**](https://www.ionos.com/pt-br/digitalguide/hospedagem/blogs/criar-um-wordpress-backup/)
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 comentário `/*That’s all, stop editing! Happy blogging.*/`
6. Por último, **salve** suas alterações na parte superior da tela

Ao realizar esse procedimento, você ativa o WordPress Debug Mode. Finalizada a verificação, é fácil desativar modo: basta **desfazer as alterações no arquivo**. Ou seja, você deve abrir novamente o arquivo, rolar até a linha mencionada acima e voltar com o valor `false`, anteriormente substituído por `true`. Assim que você salvar as alterações, o WordPress Debug Mode será encerrado. Repita esses passos quantas vezes quiser, sempre que precisar analisar o seu site em busca de erros.

## Documentação do WordPress Debug Mode

Como já explicamos, o WordPress Debug Mode pode documentar minuciosamente os erros encontrados, se assim for desejado. O procedimento também deve ser executado no arquivo `wp-config.php`. Para habilitar os relató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 registradas em um **arquivo LOG**, podendo ser analisadas sempre que necessá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 obrigatórias para a execução do WordPress Debug Mode.

## Plugins para debug no WordPress

[![Imagem: Captura de tela do plugin para WordPress WP Debugging](https://www.ionos.com/pt-br/digitalguide/fileadmin/_processed_/4/3/csm_wp-debug-plugin_8d98314dd7.webp "Captura de tela do plugin para WordPress WP Debugging")](https://www.ionos.com/pt-br/digitalguide/fileadmin/DigitalGuide/Screenshots_2021/wp-debug-plugin.png) WP Debugging é um plugin gratuito, que executa debugs no WordPress Você também pode executar um *debug* no seu site com a ajuda de [plugins WordPress](https://www.ionos.com/pt-br/digitalguide/hospedagem/blogs/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 descobertas em um arquivo de relatório. Ao desativar o plugin, modo *debug* se encerrará automaticamente.

Alternativamente (ou complementarmente), 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 ferramentas ou plugins. Relativamente abrangente, o Query Monitor fornece diversas estatísticas e informações importantes.

## 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 utilização deste recurso é relativamente fácil. Mesmo sem conhecimentos avançados, você conseguirá 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 automática e satisfatória.


This is a markdown version of: [https://www.ionos.com/pt-br/digitalguide/hospedagem/tecnologia-de-hospedagem/wordpress-debug-mode/](https://www.ionos.com/pt-br/digitalguide/hospedagem/tecnologia-de-hospedagem/wordpress-debug-mode/) for AI/LLM consumption.