Obtenha hoje o melhor plug-in de backup e migração para WordPress
Obter o Duplicator agora
Novas limpezas de cópias de segurança com um clique, eliminação automática e actualizações de versões do Duplicator

Novas limpezas de cópias de segurança com um clique, eliminação automática e actualizações de versões do Duplicator

Quer backups do WordPress mais limpos, mais organizados e mais seguros? Conheça as novas funcionalidades de gestão de registos de cópias de segurança do Duplicator e a versão actualizada...
Ferramentas de depuração do WordPress

Ferramentas de depuração do WordPress que encontram erros em minutos (não em horas) 

Escrito por: avatar do autor Joella Dunn
avatar do autor Joella Dunn
Joella é uma escritora com anos de experiência em WordPress. Na Duplicator, ela é especialista em manutenção de sites - desde backups básicos até migrações em grande escala. O seu objetivo final é garantir que o seu site WordPress está seguro e pronto para crescer.
     Avaliado por: avatar do revisor John Turner
avatar do revisor John Turner
John Turner é o presidente da Duplicator. Tem mais de 20 anos de experiência em negócios e desenvolvimento e os seus plugins foram descarregados mais de 25 milhões de vezes.

Alguma vez olhou para um erro no seu site WordPress, sentindo-se completamente impotente? Eu já passei por isso.

Não consigo contar quantas vezes me deparei com problemas misteriosos que pareciam impossíveis de resolver - até descobrir as ferramentas de depuração corretas.

Os sites WordPress são sistemas complexos com muitas partes móveis. Temas, plugins e ficheiros principais do WordPress têm todos de funcionar em conjunto na perfeição. Quando algo dá errado, encontrar o culpado pode parecer impossível.

Mas não tem de ser assim.

Com as ferramentas de depuração do WordPress corretas, pode identificar e resolver rapidamente problemas que, de outra forma, demorariam horas a localizar.

Quer esteja a lidar com conflitos de plug-ins, problemas de desempenho ou erros misteriosos de PHP, ter o conjunto de ferramentas adequado faz toda a diferença.

Neste guia, vou guiá-lo pelas ferramentas de depuração do WordPress mais eficazes que testei pessoalmente e nas quais confio. Vamos começar!

Índice

Que problemas podem ser resolvidos com as ferramentas de depuração do WordPress?

Antes de nos debruçarmos sobre ferramentas específicas, vamos falar sobre os verdadeiros problemas que poderá resolver.

A compreensão destes problemas comuns ajudá-lo-á a saber exatamente quando e como utilizar o seu conjunto de ferramentas de depuração.

O ecrã branco da morte

Aqueles momentos em que, de repente, o seu site não mostra nada a não ser um ecrã branco em branco podem ser indutores de pânico.

As ferramentas de depuração podem rastrear este problema até à sua origem, que é frequentemente um erro de PHP ou um problema de limite de memória. Em vez de tentar adivinhar o que correu mal, pode obter mensagens de erro exactas e traços de pilha que apontam para o código problemático.

Problemas misteriosos de desempenho

O seu sítio parece lento, mas não consegue perceber porquê.

As ferramentas de depuração podem revelar estrangulamentos ocultos. Mostram-lhe o tempo que cada elemento da página demora a carregar, quais as consultas à base de dados que estão a ser executadas lentamente e quais os plugins que consomem recursos excessivos.

Conflitos entre plugins e temas

Um dos problemas mais frustrantes do WordPress é quando os plugins ou temas têm software contraditório.

Pode ser difícil e demorado resolver o problema através de tentativa e erro. As ferramentas de depuração mostram-lhe exatamente que componentes estão em conflito, que erros estão a gerar e em que parte do código ocorrem esses conflitos.

Consultas à base de dados que correram mal

Já se perguntou porque é que algumas páginas carregam instantaneamente enquanto outras demoram uma eternidade? Muitas vezes, isso deve-se a consultas ineficientes à base de dados.

As ferramentas de depuração podem mostrar-lhe todas as consultas em execução na sua página, o tempo de execução de cada uma e quais as consultas redundantes ou mal optimizadas.

Erros e avisos do PHP

Muitos problemas do WordPress resultam de problemas de PHP que estão ocultos aos utilizadores regulares. Estes problemas podem variar de simples avisos a erros fatais que fazem cair o seu sítio.

Com as ferramentas de depuração corretas, é possível:

  • Ver todos os erros de PHP em tempo real
  • Compreender qual o código que despoletou o erro
  • Localizar a utilização de funções obsoletas antes que se torne um problema

Melhores ferramentas de depuração do WordPress

Quando se trata de depurar o WordPress, nenhuma ferramenta serve para tudo. É por isso que os programadores profissionais mantêm um conjunto de ferramentas de soluções de depuração.

Vamos explorar as ferramentas mais eficazes disponíveis, começando com as capacidades de depuração incorporadas no WordPress.

Depuração integrada do WordPress

O WordPress vem com poderosas funcionalidades de depuração que muitos utilizadores nem sequer sabem que existem. Testámos estas funcionalidades extensivamente em dezenas de sites e considerámo-las inestimáveis para o diagnóstico inicial de problemas.

O sistema de depuração integrado funciona adicionando constantes específicas ao seu ficheiro wp-config.php. Quando ativado, revela erros, avisos e notificações que normalmente não são visíveis.

Para ativar o modo de depuração do WordPress, terá de adicionar estas linhas ao seu ficheiro wp-config.php:

Bloco de código limpo
Copiado!

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

Eis o que mais nos impressionou durante os nossos testes:

A funcionalidade de registo de depuração do WordPress cria um registo detalhado de todos os erros, possibilitando a localização de problemas. Achámos isto particularmente útil quando lidamos com ambientes de alojamento onde os erros não são apresentados diretamente no ecrã.

Uma desvantagem notável que encontrámos foi o facto de a saída de depuração poder ser esmagadora para principiantes. Pode apresentar avisos que não estão realmente a causar problemas, tornando mais difícil a identificação de problemas reais.

Prós:

  • Gratuito e já incluído no WordPress
  • Sem impacto no desempenho quando desativado
  • Cria registos detalhados para uma investigação exaustiva
  • Detecta erros de PHP que outras ferramentas podem não detetar

Contras:

  • Requer edição manual do wp-config.php
  • Pode ser sobrecarregado com demasiados avisos
  • Sem interface visual para revisão de erros
  • Necessita de ser desativado na produção

Porque é que escolhemos a depuração integrada do WordPress:

A depuração nativa do WordPress fornece a base para todas as outras ferramentas de depuração. É frequentemente o meu primeiro passo no diagnóstico de erros porque não requer plug-ins adicionais e pode detetar problemas no nível mais profundo das operações do WordPress.

Monitor de consultas

Plugin Query Monitor

O Query Monitor surgiu como a nossa principal escolha de plug-ins de depuração do WordPress. Esta ferramenta gratuita fornece insights profundos sobre as operações do seu site. Além disso, tem uma interface fácil de usar que até mesmo os desenvolvedores mais novos podem navegar.

O que distingue o plug-in Query Monitor é a sua análise abrangente de consultas de bases de dados. A capacidade de ordenar as consultas por tempo de execução, função de chamada ou componente facilita a identificação exacta dos pontos de otimização necessários.

Consultas da base de dados do Query Monitor

Apreciei particularmente a forma como o Query Monitor decompõe o tempo de carregamento da página por componente. Pode mostrar-lhe como partes específicas do seu sítio afectam a experiência do utilizador.

Prós:

  • Análise de desempenho extremamente pormenorizada
  • Monitorização em tempo real das consultas à base de dados
  • Mostra pedidos e respostas de API HTTP
  • Rastreia erros e avisos de PHP com contexto

Contras:

  • Pode ser complicado para os principiantes
  • Requer alguns conhecimentos técnicos para interpretar os resultados
  • Ligeiro impacto no desempenho quando ativado

Porque é que escolhemos o Query Monitor:

O Query Monitor é uma das melhores ferramentas gratuitas de depuração do WordPress. É útil para depurar problemas de desempenho e problemas com a base de dados.

Chrome DevTools

Chrome DevTools

Embora não seja específico do WordPress, o Chrome DevTools é um ótimo complemento para a depuração de fluxos de trabalho. O painel de rede e o perfil de desempenho podem fornecer informações que os plug-ins do WordPress não conseguem igualar.

Se estiver a utilizar um navegador Chrome, pode clicar com o botão direito do rato num elemento do seu Web site e inspeccioná-lo. O Chrome DevTools abre-se automaticamente, dando-lhe acesso rápido ao código HTML do seu site.

Exemplo do Chrome DevTools

Com o Chrome DevTools, pode monitorizar o desempenho do seu site, depurar JavaScript, identificar melhorias no CSS e muito mais.

Prós:

  • Poderosas capacidades de depuração de front-end
  • Integrado no navegador Chrome
  • Documentação extensa disponível
  • Actualizações e melhorias regulares
  • Ferramentas avançadas de análise de desempenho

Contras:

  • Curva de aprendizagem para funcionalidades avançadas
  • Visibilidade limitada do back-end
  • Ferramenta específica do navegador
  • Não específico do WordPress
  • Não é possível aceder às informações do PHP ou da base de dados
  • Algumas caraterísticas requerem conhecimentos de desenvolvimento

Porque escolhemos o Chrome DevTools:

As suas poderosas capacidades de depuração de front-end tornam-no um complemento essencial para as ferramentas específicas do WordPress. A capacidade de depurar JavaScript e analisar pedidos de rede em pormenor preenche lacunas cruciais nas ferramentas de depuração do WordPress.

Duplicador

Plugin Duplicator Pro

O Duplicator é conhecido principalmente pela sua funcionalidade de cópia de segurança e migração, mas sabia que também é uma ferramenta valiosa para a depuração?

Antes de efetuar quaisquer alterações durante a depuração, é crucial ter uma cópia de segurança recente. O Duplicator pode criar uma cópia de segurança completa do seu site, incluindo ficheiros e a base de dados, garantindo que está preparado se algo correr mal.

Cópia de segurança completa do sítio predefinida

A depuração num site ativo pode ser arriscada. O Duplicator permite-lhe criar rapidamente um ambiente de teste. Este site de teste espelha o seu site de produção, proporcionando-lhe um local para testar e depurar quaisquer problemas em segurança.

Em vez de identificar um problema exato, pode simplesmente restaurar uma cópia de segurança. O Duplicator permite-lhe restaurar o seu sítio com um clique, revertendo instantaneamente quaisquer erros graves.

Restaurar cópia de segurança

Além disso, existe a recuperação de desastres se o seu sítio estiver completamente offline.

Opções de recuperação de desastres

Prós:

  • Cópias de segurança personalizáveis do sítio
  • Migrações de arrastar e largar para ambientes de teste
  • Restaurações com um clique
  • Recuperação de desastres
  • Armazenamento em nuvem para cópias de segurança

Contras:

  • Principalmente uma ferramenta de cópia de segurança e migração
  • Não é um plugin de depuração dedicado

Porque é que escolhemos o Duplicator:

O Duplicator dá-lhe uma rede de segurança com cópias de segurança e torna os ambientes de teste facilmente acessíveis. A sua funcionalidade de restauro torna-o uma parte essencial de qualquer kit de ferramentas de depuração.

Depuração WP

Plugin de depuração WP

Se quiser começar a depurar no WordPress, mas é um completo principiante, considere instalar o WP Debugging. Este plugin ativa o modo de depuração incorporado no WordPress para si.

Quando tiver terminado a depuração, desactive a Depuração WP. Ele removerá automaticamente as constantes de depuração dos ficheiros do seu site.

No entanto, se se sentir confortável a editar o seu ficheiro wp-config.php, ignore este plugin. Ele não oferece funcionalidade adicional além de ativar a depuração e configurar ligeiramente as exibições de erro.

Prós:

  • Interface de fácil utilização
  • Seguro para ambientes de produção
  • Opções de registo configuráveis
  • Não é necessário editar o código
  • Processo de configuração rápido

Contras:

  • Menos pormenorizado do que o Query Monitor
  • Caraterísticas avançadas limitadas

Porque é que escolhemos o WP Debugging:

A sua simplicidade torna-o perfeito para os utilizadores que necessitam de acesso rápido às funcionalidades de depuração do WordPress sem editar ficheiros de configuração.

Código WPC

Plugin WPCode

O WPCode permite-lhe inserir trechos de código personalizados diretamente no seu site WordPress sem ter de editar o ficheiro functions.php do seu tema.

Com o WPCode, pode adicionar e gerir facilmente os trechos de código do seu sítio. Possui rastreio de erros, pelo que saberá imediatamente quais os problemas no seu código PHP.

O WPCode desactiva automaticamente os maus snippets. Ele até destaca a linha de código que causou o erro, permitindo que você o corrija facilmente.

Pré-visualização de erros PHP do WPCode

Prós:

  • Simplifica a adição e gestão de fragmentos de código personalizados para depuração
  • Não é necessário editar manualmente os ficheiros do tema
  • Fácil de ativar/desativar trechos de código.
  • Interface de fácil utilização

Contras:

  • Principalmente um plugin de gestão de fragmentos de código
  • Não é um plugin de depuração dedicado

Porque escolhemos o WPCode:

O WPCode é um excelente plugin para ajudar a depurar problemas com código personalizado sem necessidade de editar quaisquer ficheiros de tema. O registo de erros torna-o uma adição valiosa ao seu arsenal de depuração.

Melhores práticas para depuração do WordPress

Nunca inicie a depuração sem uma cópia de segurança recente do seu site. Um movimento errado durante a resolução de problemas pode agravar os seus problemas.

Recomendo a utilização do Duplicator Pro para criar cópias de segurança automáticas. Terá sempre uma cópia de segurança limpa à qual recorrer.

Cópias de segurança programadas do Duplicador

Antes de efetuar a depuração, defina uma cópia de segurança completa como ponto de recuperação. Mesmo que o seu sítio esteja avariado, não quer perder mais dados. O Duplicator irá reverter o seu site para o ponto de partida se algo correr mal.

Definir a recuperação de desastres

Nunca depurar num site ativo. Configure um ambiente de preparação que espelhe o seu site de produção, onde pode testar e depurar problemas em segurança.

O Duplicator Pro torna este processo simples, permitindo-lhe criar um clone exato do seu site num ambiente de teste com apenas alguns cliques. Basta fazer uma cópia de segurança do seu sítio original e colocá-la na área de teste.

Importar uma cópia de segurança com o Duplicator

Lembre-se de que os registos de depuração podem conter informações confidenciais. Nunca partilhe publicamente os registos de depuração em bruto sem primeiro rever e redigir os dados sensíveis.

Fique atento aos recursos do servidor durante a depuração. Algumas ferramentas de depuração podem consumir muitos recursos, pelo que poderá ser necessário desativar temporariamente outros plug-ins não essenciais durante o processo de depuração.

Quando estiver a depurar, documente tudo. Mantenha notas detalhadas sobre:

  • Que alterações são efectuadas durante a depuração
  • Que erros encontra
  • Que ferramentas revelaram problemas específicos
  • Que soluções funcionaram (e não funcionaram)

Esta documentação torna-se inestimável quando surgem problemas semelhantes no futuro.

Perguntas mais frequentes (FAQs)

Como posso depurar o meu sítio Web WordPress?

Depure o WordPress activando o modo de depuração no ficheiro wp-config.php. Adicione a linha define('WP_DEBUG', true); para o ativar. Reveja os erros no registo de depuração (wp-content/debug.log). Verifique se existem conflitos de plug-ins, desactivando-os um a um, e teste com um tema predefinido.

Como é que abro as ferramentas de programador no WordPress?

Abra as ferramentas de desenvolvimento do WordPress premindo F12 ou Ctrl + Shift + I (Windows) ou Cmd + Option + I (Mac) no seu navegador Web. Isto abre as ferramentas de desenvolvimento do navegador, onde pode inspecionar o HTML para depuração.

Como é que posso ver todos os erros no WordPress?

Veja todos os erros no WordPress activando a depuração no ficheiro wp-config.php. Para visualizar os erros no ecrã, utilize define('WP_DEBUG_DISPLAY', true);. Certifique-se de que o relatório de erros está ativado na configuração do PHP do seu servidor.

Como é que executo um sítio Web em modo de depuração?

Para ativar o modo de depuração no WordPress, edite o ficheiro wp-config.php para incluir define('WP_DEBUG', true);. Para outras plataformas, consulte as respectivas definições de depuração específicas. O modo de depuração ajuda a identificar erros e regista-os para a resolução de problemas.

Qual é o melhor plugin de depuração do WordPress?

O melhor plugin de depuração do WordPress é o Query Monitor. Fornece informações detalhadas sobre consultas de bases de dados, erros de PHP, ganchos e scripts em fila de espera. Ele ajuda os desenvolvedores a identificar problemas e conflitos de desempenho. Outras opções populares incluem Debug Bar, WP Debugging, Debug This e Debug Log Manager.

Considerações finais

A depuração eficaz é essencial para manter um site WordPress saudável, mas não precisa de ser uma tarefa difícil. Com as ferramentas e a abordagem certas, pode identificar e resolver rapidamente os problemas antes que estes afectem os seus utilizadores.

Lembre-se que a depuração é mais eficaz quando é feita de forma proactiva. A manutenção e monitorização regulares do sítio podem detetar potenciais problemas antes de se tornarem questões críticas.

Já que está aqui, acho que vai gostar destes outros guias do WordPress:

Pronto para implementar um fluxo de trabalho de depuração profissional? Experimente o Duplicator Pro hoje mesmo e experimente os backups de sites e a criação de ambientes de teste sem interrupções para uma depuração mais segura.

avatar do autor
Joella Dunn Redator de conteúdos
Joella é uma escritora com anos de experiência em WordPress. Na Duplicator, ela é especialista em manutenção de sites - desde backups básicos até migrações em grande escala. O seu objetivo final é garantir que o seu site WordPress está seguro e pronto para crescer.

Divulgação: O nosso conteúdo é apoiado pelos leitores. Isto significa que, se clicar em algumas das nossas hiperligações, podemos ganhar uma comissão. Apenas recomendamos produtos que acreditamos que acrescentam valor aos nossos leitores.