[Como] Habilitar depuração do WordPress para corrigir problemas (5+ métodos)

Depuração de WordPress

… Tudo o que você precisa saber sobre como habilitar a depuração do WordPress.

Se isso já aconteceu com você, você sabe por que precisa da depuração do WordPress: você vai experimentar o melhor e mais recente plugin assim que ativar. Estrondo!

Seu site - Dead!

Você deseja desinstalar o plugin, mas não pode porque o back-end também está morto.

Ou você é um Desenvolvedor WordPress codificando um novo plug-in, mas você não consegue descobrir por que ele não está funcionando da maneira que você deseja. É por isso que a depuração é um recurso essencial para programadores e web designers.

Não seria ótimo se você pudesse descobrir facilmente os erros ao trabalhar no código para desenvolver um novo tema ou plug-in? A depuração do WordPress é um recurso interessante que permite que você encontre facilmente os erros e funções obsoletas durante a execução do código na instalação do WP.

É especialmente útil durante o processo de depuração, especialmente se você tentou implementar alguns recursos experimentais em seus temas ou plug-ins.

Por padrão, a configuração do WordPress oculta avisos PHP ao carregar uma página. Se você deseja realizar a depuração do PHP e da API do WordPress, você precisará fazer alguns ajustes para habilitar a depuração do WordPress.

Isso se deve ao fato de que a maioria dos sites não deseja mostrar erros de PHP em um site ativo. Mostrar esses erros de depuração do WordPress pode ser perigoso, pois os avisos podem revelar detalhes cruciais sobre o seu site, código, caminhos e outras informações aos visitantes do site, o que pode dar dicas aos hackers. Essas informações podem ser usadas para explorar e usar códigos maliciosos para violar seu site.

Leitura recomendada: 17 ações para evitar aumentar a segurança do WordPress

Durante a fase de desenvolvimento, o códice WP recomenda fortemente que os programadores habilitem a depuração do WordPress.

Na verdade, habilitar a depuração do WordPress irá ajudá-lo de 2 maneiras.

  • Erros de PHP: Mostra erros causados ​​por quaisquer funções PHP
  • Funções obsoletas: Estas são funções que podem ter sido usadas em versões anteriores do código, mas foram marcadas recentemente como não sendo mais usadas. Isso o ajudará a encontrar uma função substituta para usar.

Neste post, vamos dar uma olhada em várias constantes de depuração do WordPress e como ativar o registro de erros em sua instalação ou site ...

Configurações de depuração do WordPress

1. Habilite a depuração do WordPess com WP_DEBUG

depuração wp

A constante PHP mais importante que pode ser usada para habilitar o modo de depuração em seu site é WP_DEBUG.

Por padrão, esta constante PHP é definida como falsa. Será mostrado como segue em seu wp-config.php arquivo. 

define( 'WP_DEBUG', false );

Para ativar o registro, tudo que você precisa fazer é definir WP_DEBUG como verdadeiro.

Veja o código abaixo.

define( 'WP_DEBUG', true );

Abaixo estão algumas coisas que você precisa manter em mente antes de habilitar a depuração do WordPress.

  • Tenha cuidado antes de fazer qualquer alteração em seu wp-config.php porque é o arquivo mais importante em sua instalação que pode ser usado para configurar o acesso ao banco de dados, melhorar o desempenho e melhorar a segurança. Cometer um pequeno erro na configuração pode fazer com que seu site se torne inacessível
  • Certifique-se de não habilitar a depuração do WordPress em um site ativo. Como dissemos antes, informações cruciais podem ser reveladas, além do fato de que deixar a depuração do WordPress habilitada criará problemas de desempenho porque resulta em uma sobrecarga significativa

Recomendar Leitura: Como fazer backup do WordPress nativamente ou com um plugin

Agora que habilitamos a configuração para depuração do WordPress, precisaremos examinar a saída dos comandos de depuração. Para fazer isso, é melhor habilitar o arquivo de log de depuração do WordPress.

Isso pode ser feito ativando a próxima configuração em wp-config.php.

2. Registrar erros em debug.log com WP_DEBUG_LOG

Para poder revisar quaisquer erros de depuração do WordPress, avisos ou qualquer outra saída, precisaremos examinar o arquivo de depuração do WordPress. Possivelmente, você precisará enviar esse arquivo para qualquer fornecedor ou desenvolvedor de WordPress com quem você trabalha.

Para gerar o arquivo de log de depuração do WordPress, você precisará ativar o 'log de depuração do WordPress' usando a configuração WP_DEBUG_LOG. Essa constante essencialmente força o WordPress a gravar saídas de depuração em um arquivo de log.

O que esta constante PHP faz é salvar todos os avisos de erro em um debug.log localizado na configuração do diretório 'wp-content', para que você possa revisar esses avisos / erros sempre que precisar.

WP DEBUG LOG
Observe que a configuração WP_DEBUG_LOG funciona em conjunto com a constante WP_DEBUG, ou seja, o WP_DEBUG deve ser habilitado para que a configuração WP_DEBUG_LOG tenha efeito.

Aqui está como habilitar o registro de depuração para o debug.log Arquivo. Basta adicionar o seguinte código ao seu wp-config.php arquivo.

define( 'WP_DEBUG_LOG', true);

Uma vez definido como verdadeiro, todos os seus temas e erros de plug-ins serão rastreados e salvos no debug.log arquivo.

Também existe a possibilidade de definir um arquivo diferente usando uma pequena variação nesta configuração. Por exemplo, se desejar definir um local ou nome diferente para o arquivo de registro, você pode usar o seguinte:

define ('WP_DEBUG_LOG', '/logs/wordpress-errors.log');


As configurações acima não afetam o que é exibido no frontend. Isso pode ser definido independentemente usando a próxima configuração que discutiremos abaixo.

3. Habilitar / Desabilitar Erros de Exibição com WP_DEBUG_DISPLAY

Dê uma olhada na imagem abaixo. Este é o aspecto do seu site se WP_DEBUG_DISPLAY estiver ativado. Essencialmente, esta é uma configuração que força o WordPress a mostrar os erros no frontend, em vez de apenas gravá-los no arquivo de log, como vimos nas etapas anteriores.

exibindo WP DEBUG

Na maioria dos casos, se você habilitou WP_DEBUG_LOG para rastrear quaisquer erros causados ​​por seus temas e plug-ins em um arquivo de log.

No entanto, se você estiver trabalhando em um ambiente de desenvolvimento, também poderá optar por mostrar os avisos ou erros do PHP no front-end do site. 

A constante WP_DEBUG_DISPLAY no arquivo wp-config.php permite que você habilite / desabilite se as mensagens de depuração são mostradas no frontend do seu site.

Por padrão, se você habilitou a depuração do WordPress, a exibição de mensagens de erro do WordPress é definida como 'true'. Você pode defini-lo como 'falso' se quiser ocultá-los.

Tudo que você precisa fazer é adicionar a linha de código abaixo ao seu arquivo wp-config.php.

define( 'WP_DEBUG_DISPLAY', false);

Tenha cuidado ao habilitar isso em um site ativo, porque isso pode revelar informações confidenciais. Se você ativá-lo temporariamente, não se esqueça de desativá-lo depois de identificar e corrigir o problema.

4. Habilite a depuração de script com SCRIPT_DEBUG  

Depuração de script WP

Até agora, discutimos a importância do modo WP_DEBUG e como ativá-lo na instalação do seu site. Há outra constante PHP importante que você pode ativar para depuração de script do WordPress: SCRIPT_DEBUG.

Enquanto habilitar WP_DEBUG revela quaisquer erros causados ​​por funções PHP em seu tema e plug-ins do WordPress, habilitar SCRIPT_DEBUG mostra se há algum Desenvolvimento Javascript ou erros de CSS.

Na verdade, ao depurar se a constante SCRIPT_DEBUG estiver ativada, ele força o WordPress a usar a versão de desenvolvimento dos arquivos em vez da versão reduzida.

Como você deve saber, WordPress carrega versões reduzidas de arquivos CSS e JS no ambiente ao vivo. Essas versões reduzidas de arquivos removem todos os caracteres desnecessários nesses arquivos em um esforço para reduzir o tamanho do arquivo para carregamento mais rápido da página.

Recomende a leitura21 ações para tornar o WordPress mais rápido

Ao carregar arquivos minimizados pode ser extremamente útil em termos de experiência do usuário e WordPress SEO, pode ser uma dor para fins de desenvolvimento, especialmente quando você está tentando encontrar e corrigir bugs.

Forçando a instalação a carregar a versão de desenvolvimento, você pode facilmente descobrir quais scripts estão causando conflitos em seus arquivos CSS e JS principais. Usar essa configuração em conjunto com o console de ferramentas do navegador permite que você identifique onde os erros de Javascript estão sendo lançados para que você possa corrigi-los.

Para ligar SCRIPT_DEBUG, adicione o seguinte código ao seu arquivo wp-config.php.

define( 'SCRIPT_DEBUG', true );

5. Ativar / desativar o registro de consultas de banco de dados

Mais uma vez, ao depurar problemas, você pode querer anotar quais consultas de banco de dados estão sendo executadas. Em particular, se você estiver solucionando problemas e problemas de desempenho, convém verificar exatamente quais consultas estão em execução.

O wp-config.php arquivo tem outra configuração que permite que você registre todas as consultas que são executadas. Adicione a seguinte linha a w-config para permitir o salvamento de consultas. 

define ('SAVEQUERIES', true);

Depois de habilitar esta opção, todas as consultas serão salvas no $ wpdb-> queries global. Se não tiver certeza de qual é o valor da variável, você pode adicionar o seguinte script de fragmento de código PHP a um arquivo no WordPress. Isso irá gerar o valor de $ wpdb-> queries variável global.

consultas); ?>

 

Plugins de depuração

Além de mensagens de erro de log, você também pode precisar verificar o desempenho das consultas ou, de outra forma, tentar entender o que está acontecendo por baixo do capô. Existem vários outros plug-ins e ferramentas que recomendamos que você use quando precisar executar essa depuração ou solução de problemas. 

1. Monitor de consulta

o monitor de consultas é um plug-in bacana que permite que você veja exatamente o que os diferentes plug-ins em sua instalação do WordPress estão fazendo. Mesmo que o nome diga que é um "monitor de consulta", este plugin faz mais do que apenas monitorar consultas de banco de dados.

captura de tela do monitor de consulta

Na verdade, este plug-in pode:

  • depurar consultas
  • monitorar erros de PHP
  • verificar ganchos e ações
  • Chamadas de API HTTP
  • monitorar scripts e folhas de estilo enfileirados 
  • depuração de chamadas AJAX
  • etc.

Você também pode restringir esse monitoramento por plug-in ou tema, o que ajuda a restringir as fontes de problemas.

2. Barra de depuração

Este plugin é normalmente usado por desenvolvedores à medida que codificam seus temas ou plug-ins. O plug-in adiciona um menu de depuração à barra de administração do WordPress que mostra a consulta, o cache e outras informações de depuração do WordPress. 

O bom é que ele respeita as configurações de depuração do WordPress descritas acima.

3. Registrar Avisos Obsoletos

Esta é uma outra plugin orientado para o desenvolvedor. Basicamente, registra se você está usando funções, arquivos ou argumentos obsoletos, de forma que você possa atualizar e corrigir seu código para usar as recomendações mais recentes.

Escrevendo no registro de depuração do WordPress

Como desenvolvedor, você provavelmente deve adicionar informações de erro ao log de depuração do WordPress conforme necessário. Para fazer isso, você precisa usar uma função específica do WordPress que envia mensagens para o log:

error_log( "This is a log entry" );

Se a depuração estiver habilitada, a mensagem acima aparecerá no arquivo de log. Você pode usar o acima para registrar exceções ou outros problemas inesperados.

PERGUNTAS FREQUENTES

O que a depuração do WordPress faz?

As várias configurações de depuração do WordPress permitem a visualização de quaisquer avisos, como erros, funções obsoletas ou quaisquer outros logs de erros gerados por temas, plug-ins e outras funções do WordPress. Ao habilitar as configurações acima, você pode identificar e corrigir quaisquer erros em seus plug-ins ou temas do WordPress.

Onde está o log de depuração do WordPress?

O log de depuração do WordPress geralmente é encontrado no diretório raiz com o nome debug.log. Usando as configurações acima, você pode alterar o local do log de depuração do WordPress para um local que seja mais conveniente para você.

Como desativo a depuração no WordPress?

Para desabilitar a depuração no WordPress, simplesmente adicione a seguinte entrada ao seu arquivo wp-config.php: define ('WP_DEBUG', false); Você também pode verificar o restante das configurações que descrevemos neste artigo.

O que WP Debug faz?

A configuração WP Debug no arquivo wp-config.php é usada para habilitar ou desabilitar a depuração do WordPress.

A depuração do WordPress afeta o desempenho?

Sim, a depuração do WordPress tem um impacto no desempenho porque adiciona alguma sobrecarga, incluindo a necessidade de saída para um arquivo. Recomenda-se que, ao concluir a depuração, desative todas essas configurações. Isso também torna sua instalação mais segura, uma vez que informações confidenciais podem ser incluídas nos logs de depuração.

Resumo

Se você quiser um rápido resumo de tudo o que discutimos, dê uma olhada no arquivo de exemplo wp-config.php abaixo com todas as configurações em vigor: 

// Habilita o modo WP_DEBUG - para desabilitar basta colocar false em vez de true define ('WP_DEBUG', true); // Habilita o registro de depuração no arquivo /wp-content/debug.log define ('WP_DEBUG_LOG', true);
// Comente o arquivo acima e descomente o abaixo para registrar em um arquivo específico
// define ('WP_DEBUG_LOG', '/logs/wordpress-errors.log'); // Desabilita a exibição de erros e avisos / muda para verdadeiro para habilitar define ('WP_DEBUG_DISPLAY', false); // Use versões dev dos arquivos principais JS e CSS (necessários apenas se você estiver modificando esses arquivos principais) define ('SCRIPT_DEBUG', true);

// Log de consultas habilitado, mude para falso para desabilitar
define ('SAVEQUERIES', true);

Você já ativou a depuração do WordPress? Compartilhe suas idéias conosco na seção de comentários ...

Baixe a lista de 101 truques do WordPress que todo blogueiro deve saber

101 truques do WordPress

Clique aqui para baixar agora
 

Precisa de ajuda para fazer as coisas? Experimente esses shows acessíveis com melhor classificação no Fiverr!

logotipo da fiverr

Clique aqui para encontrar especialistas em corrigindo problemas do WordPress.

Clique aqui para criar um site WordPress completo.

Sobre o autor
Shahzad Saeed
Autor: Shahzad SaeedSite: http://shahzadsaeed.com/
Shahzaad Saaed foi destaque em um grande número de sites de autoridade, como um especialista em WordPress. Ele é especialista em marketing de conteúdo para ajudar as empresas a aumentar o tráfego.

Mais uma coisa... Você sabia que as pessoas que compartilham coisas úteis como esta postagem também parecem FANTÁSTICAS? ;-)
. deixe um útil comente com suas ideias, depois compartilhe com seu (s) grupo (s) do Facebook, que considerariam isso útil e vamos colher os benefícios juntos. Obrigado por compartilhar e ser legal!

Divulgação: Esta página pode conter links para sites externos de produtos que amamos e recomendamos de todo o coração. Se você comprar produtos que sugerimos, podemos receber uma taxa de referência. Essas taxas não influenciam nossas recomendações e não aceitamos pagamentos por análises positivas.

Autor (es) em destaque em:  Logotipo da revista Inc   Logotipo do Sitepoint   Logotipo do CSS Tricks    logotipo do webdesignerdepot   Logotipo WPMU DEV   e muitos mais ...