Como ativar o modo de depuração do WordPress: 2 métodos

Você está procurando maneiras de solucionar conflitos em seu site? Encontrar a causa dos problemas pode economizar muito tempo, portanto, se isso é algo que lhe interessa, este post é para você. Neste guia, mostraremos duas maneiras de ativar o modo de depuração do WordPress e encontrar conflitos em seu site.

Independentemente de quão cuidadoso você seja, se você tiver um site, sempre enfrentará vários problemas. A solução de problemas desses erros nem sempre é fácil e pode levar horas para encontrar a raiz dos conflitos. É por isso que saber como solucionar esses problemas e resolvê-los é fundamental para evitar dores de cabeça. Neste artigo, você aprenderá como habilitar o modo de depuração no WordPress e corrigir seus problemas rapidamente.

Antes de entrarmos nisso, vamos entender melhor o que é o modo de depuração.

O que é o modo de depuração?

O modo de depuração é uma técnica que os desenvolvedores usam para identificar possíveis ameaças e avisos causados ​​por PHP ou outras linguagens de programação. Como você provavelmente sabe, o WordPress é construído com PHP, JavaScript, HTML e CSS, então você pode enfrentar alguns erros causados ​​por erros no código. Por exemplo, seu site pode ser comprometido quando você:

• Atualizar a versão do PHP
• Adicionar código personalizado
• Instale um novo tema/plugin
• Atualize seu tema/plugins
• Atualizar WordPress

Normalmente, seus plugins causam conflitos devido a uma atualização ou incompatibilidade. Os problemas variam muito e vão desde um conflito inofensivo até a criação de problemas na página de checkout ou a tela branca da morte se você não tiver sorte. Por padrão, o WordPress não vem com uma função embutida para monitorar esses conflitos, então pode ser um desafio saber o que está acontecendo. A boa notícia é que você pode fazer algumas coisas para poder ver os erros e corrigi-los antes que seja tarde demais. Isso permite que você solucione problemas com mais precisão e resolva os problemas muito mais rapidamente.

Quando você habilita o modo de depuração, o WordPress exibirá todos os erros na área de administração logo abaixo da barra de navegação superior. Dessa forma, você pode ficar de olho nos avisos rapidamente e corrigir o que for necessário. Mesmo que nem todos os erros precisem de atenção urgente, corrigi-los assim que aparecerem ajudará você a garantir que as coisas não piorem e oferecer uma ótima experiência ao usuário.

Agora vamos ver diferentes maneiras de ativar o modo de depuração .

Como ativar o modo de depuração do WordPress

Você pode ativar o modo de depuração do WordPress de duas maneiras:

1. Manualmente
2. Usando um plug-in

Nesta seção, mostraremos os dois métodos para que você possa escolher o melhor de acordo com suas necessidades.

1) Ative o modo de depuração manualmente

Se você tem habilidades de codificação e se sente confortável em editar arquivos principais, esse método é para você. Para habilitar o modo de depuração, você precisará adicionar um trecho de código ao seu arquivo wp-config.php . Você pode usar um cliente FTP como o FileZilla ou um plugin de gerenciador de arquivos dedicado. Para esta demonstração, usaremos o plugin Gerenciador de Arquivos.

NOTA : As alterações que faremos são bastante simples, mas é sempre recomendável criar um backup do seu site antes de iniciar.

1.1) Instalar e ativar o gerenciador de arquivos

A primeira coisa que você precisa fazer é instalar e ativar o plugin Gerenciador de Arquivos na sua instalação do WordPress. Vá para Plugins > Adicionar Novo, procure o plugin e instale-o.

1.2) Configuração do Plugin

Após a ativação, abra as configurações do plugin em WP File Manager . Lá, você verá todos os diretórios e arquivos hospedados em seu servidor.

Antes de modificar o arquivo wp-config.php , recomendamos que você baixe uma cópia dele para seu computador local. Dessa forma, se algo der errado, você poderá remover facilmente a versão modificada e fazer upload do arquivo pai. Dessa forma, você pode adicionar uma precaução extra.

Depois de baixar o arquivo, no Gerenciador de Arquivos, clique com o botão direito do mouse no arquivo wp-config.php e use a opção Editor de Código para modificá-lo.

1.3) O trecho

Depois de abri-lo, você verá o editor. A partir daí, você pode adicionar ou remover o código do arquivo.

Se você rolar até o final, verá uma linha que diz /* Isso é tudo, pare de editar! Publicação feliz. */. Copie o código a seguir e cole-o logo antes dessa linha.

 define( 'WP_DEBUG', true );

O código simplesmente diz ao WordPress para ativar o modo de depuração.

Se o seu arquivo wp-config.php já tiver esse snippet, mas a constante estiver configurada como false, não será necessário adicionar o código novamente. Tudo que você precisa fazer é trocar a palavra false por true .

Isso não é tudo. O problema com esse snippet é que ele exibirá todos os conflitos do seu site (se houver algum) no front e no backend. Isso significa que, se o seu site estiver ativo, os visitantes poderão ver os alertas e isso poderá confundi-los. Não há como escondê-los? Sim existe! Além disso, manter um registro de todos os problemas pode ser útil.

1.4) Snippet para ocultar alertas do front-end

Para ocultar os alertas e manter o log, use o snippet abaixo e cole-o abaixo do código de depuração que você acabou de adicionar.

 // Salva debug.log em /wp-content/debug.log
 define( 'WP_DEBUG_LOG', true );

 // Ocultar erros e avisos
 define( 'WP_DEBUG_DISPLAY', false );
 @ini_set( 'display_errors', 0 ); 

Quando terminar, lembre-se de salvar as configurações e pronto! Agora você ativou o modo de depuração no WordPress manualmente . A partir de agora, você poderá ficar de olho nos alertas, mas os visitantes do seu site não os verão no front-end.

Se você não se sente confortável com esse método, há outra alternativa para você.

2) Habilite o modo de depuração com um plugin

Se você não quiser editar os arquivos principais, poderá ativar o modo de depuração com um plug-in. Nesta seção, mostraremos como fazer isso passo a passo.

WP Debugging é um plugin dedicado para habilitar o modo de depuração em qualquer instalação do WordPress. Nesta seção, você aprenderá como fazê-lo passo a passo.

2.1) Instalação e Ativação do WP Debugging

Antes de tudo, você precisa instalar e ativar o plugin WP Debugging em seu site. Este plugin está no repositório, então, no seu painel de administração, vá para Plugins > Add New , procure o plugin e instale-o.

2.2) Configuração do Plugin

Depois de instalar e ativar o plug-in, você verá a configuração na seção Ferramentas .

O plugin adicionará automaticamente este código ao seu arquivo wp-config.php :

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

Este código ativou o modo de depuração. Basta marcar a opção “Set WP-DEBUG to true” e salvar as alterações.

Isso também exibirá os erros no front end, então recomendamos que você também selecione a opção “ Set WP_DEBUG_DISPLAY to false, default is true” para ocultar os alertas.

Depois disso, visite algumas páginas do site onde você tiver problemas ou conflitos para garantir que as mensagens não estejam lá. Por fim, você também pode verificar se há mensagens de erro no arquivo debug.log .

E é assim que você pode habilitar o modo de depuração no WordPress com um plugin. Lembre-se de que, se você desinstalar o WP Debugging, o código adicionado será removido.

Ativar o modo de depuração é o primeiro passo. Agora você precisa saber como verificar as mensagens de erro para corrigi-las o mais rápido possível. Vamos ver como fazer isso.

Como verificar mensagens de erro

Depois de ativar o modo de depuração, o WordPress armazenará um log de todos os problemas em seu servidor. Você pode encontrar o log em seu gerenciador de arquivos usando um cliente FTP ou com um plug-in dedicado. Nesta seção, você aprenderá como verificar as mensagens de erro corretamente.

Para esta demonstração, usaremos o plug-in Gerenciador de Arquivos, mas você poderá seguir a explicação independentemente do método escolhido.

Primeiro, abra a pasta wp-content . Lá, você verá um novo arquivo chamado debug.log que contém o log de todos os erros.

Abra o arquivo e você verá todos os erros que precisa corrigir com data e hora.

NOTA: A ativação do modo de depuração e a solução de problemas em um site ativo não é uma prática recomendada. Em vez disso, você pode criar um ambiente de teste e fazer todos os testes necessários lá. Depois de ter a solução, você pode aplicá-la ao seu site ao vivo. A maioria das empresas de hospedagem WordPress oferece ambientes de teste gratuitos para fins de teste e desenvolvimento, então isso não deve ser difícil.

Conclusão

Em suma, por padrão, o WordPress não possui uma função embutida para monitorar bugs e conflitos. Isso torna difícil saber qual é o problema e, portanto, resolvê-lo.

O modo de depuração permite encontrar bugs e erros e corrigi-los rapidamente. Neste guia, vimos duas maneiras diferentes de ativar o modo de depuração no WordPress:

• Manualmente com um pouco de código
• Com um plug-in

Se você se sentir confortável em editar arquivos principais, poderá ativar o modo de depuração manualmente com algumas linhas de código. Esse método é direto e não afeta a velocidade e o desempenho do seu site. Por outro lado, você pode usar um plug-in para ativar o modo de depuração sem precisar editar nenhum arquivo principal. Este método é perfeito para iniciantes, pois permite que você tenha o modo de depuração funcionando em apenas alguns cliques. Ambos os métodos são eficazes, portanto, escolha o que melhor se adapta às suas necessidades e preferências.

Por fim, se você quiser aprender a corrigir alguns dos problemas mais comuns do WordPress, dê uma olhada nos seguintes guias:

• O login do WordPress não está funcionando? Como corrigi-lo
• Como corrigir links permanentes do WordPress
• Corrija o erro de falha na atualização do WordPress
• Como resolver o erro do link que você seguiu expirou no WordPress

Você ativou o modo de depuração em seu site? Qual método você usou? Deixe-nos saber nos comentários abaixo!