Como ativar o modo de depuração do WordPress para corrigir erros

Como você pode ativar o modo de depuração no WordPress ou obter mais informações sobre erros do WordPress exibidos em um navegador da web? Se você é um usuário ou desenvolvedor do WordPress e está fazendo essas perguntas, você encontrou o recurso certo. Este guia mostrará como habilitar os recursos de depuração do WordPress.

O WordPress fornece várias ferramentas de depuração poderosas para desenvolvedores e não programadores ou usuários em geral, que você pode ativar usando as opções de configuração disponíveis. Essas opções, uma vez ativadas, ajudam você a encontrar e resolver erros rapidamente, mostrando informações detalhadas sobre os erros.

Demonstraremos usando o seguinte erro que encontramos ao configurar um site fictício para fins de teste.

Quando você olha para esse erro, não há muitas informações que o acompanhem. Pode haver muitas causas para isso: o servidor do banco de dados pode estar inoperante ou as configurações de conexão do banco de dados (ou seja, nome do banco de dados, usuário do banco de dados e senha do usuário) definidas no arquivo de configuração wp-config.php podem estar errado.

Então, como podemos obter mais informações sobre o erro acima? A opção WP_DEBUG é uma variável global permanente do PHP que ativa o modo “debug” em todo o WordPress, fazendo com que todos os erros, avisos e avisos do PHP sejam exibidos no navegador.

Este recurso “debug ” foi adicionado na versão do WordPress 2.3.1 e está configurado em wp-config.php – um dos arquivos mais importantes na instalação do WordPress.

Por padrão, o recurso “debug” é definido como false em qualquer instalação do WordPress. Para ativar WP_DEBUG, defina-o como true.

Primeiro, vá para o diretório de instalação do seu site, por exemplo, /var/www/html/mysite.com e, em seguida, abra o arquivo wp-config.php usando seu editor de texto favorito.

cd /var/www/html/mysite.com
sudo vim wp-config.php

Procure esta linha.

define( 'WP_DEBUG',  false );

e mude para

define( 'WP_DEBUG', true );

Salve o arquivo e feche-o.

Agora o modo de depuração foi acionado. Se recarregarmos a página que apresentou o erro, poderemos ver as informações detalhadas do erro conforme mostrado na imagem a seguir.

Existem opções adicionais de debug que estendem o WP_DEBUG que são particularmente úteis para desenvolvedores WordPress que criam plug-ins ou temas, ou quaisquer outros componentes. Eles são WP_DEBUG_LOG e WP_DEBUG_DISPLAY.

A opção WP_DEBUG_LOG quando definida como true faz com que todos os erros sejam salvos em um arquivo de log debug.log dentro de /wp-content / diretório por padrão. Isto é útil para análise ou processamento posterior.

define( 'WP_DEBUG_LOG', true );

Mas você pode especificar um arquivo de log personalizado, por exemplo, /var/log/nginx/mysite.com_wp-errors.log:

define( 'WP_DEBUG_LOG', '/var/log/nginx/mysite.com_wp-errors.log' );

E WP_DEBUG_DISPLAY controla se as mensagens de depuração são mostradas dentro do HTML das páginas ou não. Por padrão, está definido como true. Para desativá-lo, defina-o como falso.

define( 'WP_DEBUG_DISPLAY', false );

Habilite o modo de depuração no WordPress usando plugin

Se você estiver usando hospedagem compartilhada, provavelmente não terá acesso ao backend do servidor para editar seus arquivos WordPress, neste caso o arquivo wp-config.php.

Ou se você simplesmente preferir alterar as configurações no painel de administração, você pode instalar e usar um plugin chamado “Debug Bar” que permite ativar/desativar facilmente WP_DEBUG no painel de administração com um único clique no Barra de ferramentas.

A característica matadora deste plugin é que ele é à prova de falhas e inteligente, ele sai automaticamente do modo WP_DEBUG em caso de erros.

Referência: Depuração no WordPress.