Como ativar o modo de depuração no WordPress

Ativar o modo de depuração requer a edição de um arquivo da sua instalação do WordPress. É um processo simples, mas deve ser feito com cuidado para evitar quebrar o site. A seguir, você encontrará instruções passo a passo de como fazer isso corretamente.

Uma vez ativado, você poderá registrar erros, ocultá-los dos visitantes e controlar como o WordPress lida com as informações de depuração. Isso é especialmente importante em sites em produção, onde os erros precisam ser registrados, mas não exibidos publicamente.

Localizando o arquivo wp-config.php

O primeiro passo para ativar o modo de depuração é localizar o arquivo wp-config.php. Este arquivo está na pasta raiz da sua instalação do WordPress, no mesmo local onde se encontram wp-content, wp-includes e wp-admin. Para acessá-lo, você pode usar um software FTP, o gerenciador de arquivos do painel de hospedagem ou o acesso local se estiver trabalhando em um servidor de desenvolvimento.

É recomendável fazer um backup desse arquivo antes de realizar alterações. Um único caractere faltando pode quebrar o seu site, e ter uma cópia garante que você possa restaurá-lo imediatamente. Depois de encontrar o arquivo, abra-o em um editor de texto e prepare-se para ajustar a configuração.

Ativando o WP_DEBUG

Dentro do arquivo wp-config.php, role até encontrar uma linha como esta: define( 'WP_DEBUG', false );. Essa linha controla se o modo de depuração está ativo ou não. Por padrão, o WordPress desativa a depuração por motivos de segurança e desempenho. Para ativá-lo, basta alterar o valor de false para true.

A linha correta deve ficar assim: define( 'WP_DEBUG', true );. Depois de salvar o arquivo, o WordPress começará imediatamente a exibir avisos, notificações e mensagens de erro do PHP em todo o site. Isso permite identificar plugins, temas ou códigos personalizados problemáticos.

Usando o WP_DEBUG_LOG para registrar erros

Embora exibir erros na tela possa ser útil em desenvolvimento, nem sempre é prático. Para monitoramento a longo prazo, você pode ativar o WP_DEBUG_LOG. Para isso, adicione a seguinte linha logo abaixo da constante WP_DEBUG: define( 'WP_DEBUG_LOG', true );. Isso armazenará todos os erros em um arquivo debug.log dentro do diretório wp-content.

Ter um arquivo de log é especialmente útil quando você precisa rastrear erros que acontecem em momentos específicos ou que não podem ser reproduzidos diretamente na tela. Também permite compartilhar o arquivo com desenvolvedores ou equipes de suporte sem dar acesso direto ao site.

Ocultando erros dos visitantes

Se o seu site WordPress estiver em produção, provavelmente você não vai querer que os visitantes vejam mensagens de erro brutas. Nesse caso, você pode adicionar outra configuração para desativar a exibição no frontend: define( 'WP_DEBUG_DISPLAY', false );. Assim, os erros continuarão a ser registrados, mas não serão exibidos para os usuários.

Além disso, você pode adicionar @ini_set( 'display_errors', 0 ); para reforçar esse comportamento. Essa combinação mantém o site profissional e seguro, ao mesmo tempo em que fornece as informações necessárias no arquivo de log para administradores e desenvolvedores.

Depuração avançada com SCRIPT_DEBUG

Para desenvolvedores que trabalham com JavaScript e CSS, o WordPress oferece uma constante adicional: define( 'SCRIPT_DEBUG', true );. Por padrão, o WordPress carrega versões minificadas de scripts e estilos. Ao ativar a depuração de scripts, o WordPress passa a carregar as versões completas e não minificadas, que são mais fáceis de inspecionar e depurar.

Essa configuração é valiosa se você estiver desenvolvendo temas ou plugins e precisar analisar o comportamento de scripts e estilos. Não é geralmente necessária para usuários comuns, mas pode fazer grande diferença para desenvolvedores que estão solucionando problemas no frontend.

Em resumo, ativar o modo de depuração do WordPress é uma forma simples, mas poderosa, de diagnosticar e manter o seu site. Ao editar o arquivo wp-config.php, você pode exibir erros, armazená-los em logs e manter a aparência profissional do site mesmo durante falhas. Quando usado corretamente, o modo de depuração é uma das ferramentas mais importantes para manter o WordPress seguro, estável e amigável para desenvolvedores.