Como Habilitar Facilmente o Modo de Depuração do WordPress para Corrigir Erros no Site

Já encontramos nossa cota de erros no WordPress — telas brancas, páginas ausentes e conflitos de plugins que parecem surgir do nada.

Às vezes, o WordPress não mostra o que está dando errado por padrão. Você apenas vê uma página em branco ou uma mensagem vaga que não ajuda muito.

É aí que entra o modo de depuração. Ele oferece uma visão dos bastidores do que está causando o problema para que você possa corrigi-lo mais rapidamente.

Neste guia, mostraremos como ativar o modo de depuração do WordPress com segurança — usando código ou um plugin — e como ler o log de erros se algo der errado em seu site.

O que é o Modo de Depuração no WordPress?

O modo de depuração é uma ferramenta integrada no WordPress que ajuda você a ver o que está acontecendo nos bastidores quando algo dá errado em seu site.

Por padrão, o WordPress oculta mensagens de erro técnico de visitantes e até mesmo de você. O modo de depuração reativa essas mensagens para que você possa ver o que está causando o problema.

É como acender uma lanterna em um quarto escuro. De repente, os erros que estavam ocultos se tornam visíveis e você pode identificar de onde o problema está vindo.

Seja um conflito de plugin, um erro de digitação no código ou um problema de tema, o modo de depuração ajuda você (ou seu desenvolvedor) a obter os detalhes necessários para corrigi-lo.

Por que ativar o Modo de Depuração do WordPress?

Às vezes, um plugin do WordPress, tema ou código personalizado como PHP ou JavaScript pode causar conflitos em seu site.

Isso pode levar a diferentes erros, e você pode notar que seu site não está funcionando corretamente.

Agora, você sempre pode desativar todos os plugins para ver qual deles está causando o erro. Da mesma forma, você pode mudar para um tema do WordPress diferente ou remover o código personalizado para encontrar a causa raiz do erro.

No entanto, tudo isso leva muito tempo, pois você terá que descartar cada possibilidade uma por uma.

Felizmente, o WordPress vem com um modo de depuração integrado. No entanto, ele está desativado por padrão e você precisará ativá-lo manualmente.

Uma vez ativado, o modo de depuração mostra um registro de todos os erros e avisos em seu site.

Dessa forma, você pode identificar problemas em seu site WordPress e corrigi-los rapidamente. Ele até descobre erros que podem não ser visíveis de outra forma.

Usamos as ferramentas de depuração integradas do WordPress para solucionar problemas em todos os sites. Frequentemente, essas ferramentas fornecem pistas rápidas que nos ajudam a corrigir facilmente os problemas que estamos tendo.

Vamos ver como ativar o modo de depuração do WordPress. Mostraremos dois métodos. Você pode usar um plugin do WordPress ou visualizar manualmente o modo de depuração:

• Método 1: Ativar o Modo de Depuração do WordPress Usando um Plugin
• Método 2: Ativar Manualmente o Modo de Depuração do WordPress
• 🔧 Recursos Bônus: Aprofunde Suas Habilidades de Depuração do WordPress

Método 1: Ativar o Modo de Depuração do WordPress Usando um Plugin

Uma maneira fácil de ativar o modo de depuração é usando o plugin WP Debugging. Este método é recomendado para iniciantes e para aqueles que não se sentem confortáveis em trabalhar com os arquivos do site.

WP Debugging é um plugin gratuito do WordPress que funciona imediatamente. Ao usar este plugin, você não precisará editar os arquivos do seu site manualmente.

Primeiro, você precisará instalar e ativar o plugin WP Debugging. Para mais detalhes, consulte nosso guia sobre como instalar um plugin do WordPress.

Após a ativação, você pode ir para Ferramentas » WP Debugging no seu painel do WordPress. Em seguida, certifique-se de que a opção 'Definir WP_DEBUG como true' esteja ativada.

Depois, você verá uma opção ‘Debug Quick Look’ adicionada à sua barra de administração no topo.

Vá em frente, passe o mouse sobre ela e clique na opção ‘View File’.

Isso abrirá o arquivo de log com todos os erros em seu site. Você poderá então descobrir o que está causando problemas em seu site e corrigi-los rapidamente.

Quando terminar de depurar seu site, não se esqueça de desativar o plugin.

Método 2: Ativar Manualmente o Modo de Depuração do WordPress

O segundo método para habilitar o modo de depuração do WordPress é editar os arquivos wp-config.php. Este método é mais avançado e adequado para usuários que se sentem confortáveis editando arquivos de sites.

Recomendamos fazer um backup do seu site antes de editar os arquivos. Dessa forma, você pode restaurar facilmente seu site se algo der errado.

Você precisará de um cliente FTP para Mac ou Windows para acessar os arquivos do site.

Para este tutorial, usaremos o cliente FTP FileZilla. Se precisar de ajuda, consulte nosso guia sobre o que é FTP e como usá-lo.

Uma vez conectado, vá para a pasta public_html. O arquivo ‘wp-config.php’ está localizado aqui.

Alternativamente, muitos serviços de hospedagem WordPress também permitem que você gerencie os arquivos do seu site usando o cPanel.

Por exemplo, no Bluehost, faça login na sua conta de hospedagem e clique no botão ‘Configurações’ abaixo do seu site.

Isso abrirá a página de configurações do seu site.

Role um pouco para baixo e clique no botão ‘Gerenciador de Arquivos’.

Isso abrirá o aplicativo Gerenciador de Arquivos em uma nova aba do navegador.

A partir daqui, simplesmente acesse a pasta public_html no painel à sua esquerda.

Depois disso, role para baixo até o arquivo ‘wp-config.php’.

Em seguida, você pode clicar com o botão direito no arquivo e baixá-lo para o seu computador. É inteligente fazer uma cópia do arquivo como backup, caso algo dê errado.

Depois disso, abra o arquivo usando qualquer software ou ferramenta como o Bloco de Notas ou o Sublime Text.

Uma vez que o arquivo estiver aberto, role para baixo até a linha ‘That's all, stop editing! Happy publishing‘ e adicione o seguinte código antes dela:

define( 'WP_DEBUG', true); define( 'WP_DEBUG_LOG', true); 

Não se esqueça de salvar o arquivo antes de fechá-lo.

Em seguida, você precisará fazer o upload do arquivo wp-config.php de volta para o servidor do seu site usando o cliente FTP.

Para mais detalhes, consulte nosso guia sobre como usar FTP para fazer upload de arquivos para o WordPress.

Para visualizar os logs de erro do seu site, você precisará visualizar os arquivos do seu site e navegar até o caminho public_html/wp-content/debug.log. Simplesmente baixe o arquivo e visualize-o usando o software Bloco de Notas/TextEdit para ver os problemas no seu site.

Assim que terminar de depurar seu site, você poderá desativar o modo de depuração.

Para desativar o modo de depuração no WordPress, repita estas etapas e, em seguida, remova o código que você adicionou ao arquivo wp-config.php ou edite o seguinte código para ter um valor falso:

define( 'WP_DEBUG', false); 

🔧 Recursos Bônus: Aprofunde Suas Habilidades de Depuração do WordPress

Agora que você aprendeu como ativar o modo de depuração no WordPress, pode se interessar em aprimorar ainda mais seu kit de ferramentas de solução de problemas. Aqui estão alguns guias para iniciantes para ajudá-lo a navegar por problemas comuns e otimizar o desempenho do seu site:

• Guia para Iniciantes para Solucionar Erros do WordPress: Uma abordagem passo a passo para identificar e resolver problemas comuns do WordPress.
• Como Corrigir o Erro Crítico no WordPress: Aprenda como lidar com um dos erros mais alarmantes do WordPress de forma eficaz.
• Como Corrigir a Tela Branca da Morte do WordPress: Descubra soluções para recuperar seu site de um problema de tela em branco.
• Noções Básicas de Inspecionar Elemento: Personalizando o WordPress para Usuários DIY: Utilize ferramentas do navegador para depurar e personalizar seu site sem afetar o conteúdo ativo.
• Como Monitorar a Atividade do Usuário no WordPress com Logs de Auditoria de Segurança: Mantenha o controle sobre alterações e atividades em seu site para identificar problemas potenciais precocemente.

Esperamos que este artigo tenha ajudado você a aprender como ativar o modo de depuração do WordPress para corrigir erros no site. Você também pode querer ver nossos guias sobre como corrigir erros comuns do WordPress ou como adicionar avisos personalizados de administrador no WordPress.

Se você gostou deste artigo, por favor, inscreva-se em nosso Canal do YouTube para tutoriais em vídeo do WordPress. Você também pode nos encontrar no Twitter e no Facebook.