Dominar a depuração do WordPress: Do básico às técnicas avançadas 

Quer seja um programador experiente ou um proprietário de site curioso, a depuração é a sua arma secreta para um site mais saudável e mais feliz.

Neste guia, estamos a mergulhar no mundo da depuração do WordPress. Não se preocupe - não é tão assustador quanto parece. Vamos guiá-lo através do que é a depuração, porque é importante, e como fazê-lo eficazmente.

No final desta publicação, terá o conhecimento necessário para detetar e corrigir erros e manter o seu site WordPress a funcionar corretamente.

Pronto para se tornar um profissional de resolução de problemas do WordPress? Vamos começar!

Índice

Mas a questão é a seguinte: a depuração não é apenas para quando as coisas correm mal. É também uma forma poderosa de otimizar o seu site, mesmo quando tudo parece estar bem. A depuração pode ajudá-lo a detetar possíveis problemas antes que eles se tornem problemas reais.

Portanto, quer esteja a tentar corrigir um plugin avariado ou apenas queira fazer com que o seu site funcione mais rapidamente, a depuração é a sua estratégia de eleição. É uma habilidade essencial para qualquer pessoa que queira manter um site WordPress saudável e de alto desempenho.

Porque é que a depuração é importante?

Poderá estar a perguntar-se: "Preciso mesmo de me preocupar com a depuração?" A resposta curta é sim, e vou explicar porquê.

1. Mantém o seu sítio a funcionar sem problemas

A depuração regular é como a manutenção de rotina. Ajuda-o a detetar pequenos problemas antes que se transformem em problemas grandes e dispendiosos. Ao corrigir pequenas falhas atempadamente, mantém o seu site a funcionar corretamente.

2. Aumenta o desempenho

Já visitou um sítio Web lento? É frustrante, não é? 

A depuração pode ajudá-lo a identificar o que está a tornar o seu site mais lento. Talvez seja um plugin volumoso ou uma consulta de base de dados ineficiente. Quando souber o culpado, pode corrigi-lo e aumentar a velocidade do seu site.

3. Reforça a segurança

Os piratas informáticos adoram explorar as vulnerabilidades dos sítios Web. A depuração pode ajudá-lo a detetar potenciais pontos fracos de segurança. Ao corrigi-los, está essencialmente a colocar fechaduras mais fortes nas portas do seu sítio.

4. Melhora a experiência do utilizador

Um sítio com erros pode afastar os visitantes muito rapidamente. A depuração regular garante que o seu sítio funciona como deve ser, mantendo os seus visitantes satisfeitos e a voltar para mais.

5. Poupa tempo (e dores de cabeça) a longo prazo

É claro que a depuração leva algum tempo no início. Mas não é nada comparado com o tempo que passará a lidar com uma grande falha no site ou a tentar perceber porque é que a sua última atualização avariou tudo.

6. Facilita as actualizações

Quando o seu site é bem mantido através de depuração regular, a aplicação de actualizações torna-se muito mais fácil. É menos provável que se depare com problemas de compatibilidade ou interrupções inesperadas.

Eis o que o WP_DEBUG pode fazer:

• Detetar erros que podem fazer cair o seu sítio
• Detetar potenciais problemas antes que eles causem problemas
• Corrigir conflitos de plugins
• Depurar código personalizado
• Escreva melhor o código vendo os erros à medida que o desenvolve

Lembre-se, WP_DEBUG é apenas uma ferramenta no seu arsenal de depuração, mas é uma ferramenta poderosa. Usada sabiamente, ela pode fornecer informações úteis de depuração para que você possa otimizar seu site WordPress.

Como ativar a depuração do WordPress

Existem várias formas de ativar a depuração no WordPress, cada uma com as suas próprias vantagens. Iremos analisar estes métodos um a um, começando pelo mais fácil e passando para técnicas mais avançadas.

Método 1. Usar um plugin de depuração do WordPress

Se você é novo na depuração ou prefere uma abordagem amigável, os plug-ins de depuração do WordPress são seus melhores amigos. Eles fornecem uma maneira simples e visual de identificar e solucionar problemas sem mergulhar no código.

Um plugin simples é o WP Debugging. Este irá ativar o modo WP_Debug para si, para que não tenha de se preocupar com a edição de ficheiros.

Uma vez ativado, vá para Ferramentas " Depuração WP. Marque a caixa ao lado de Definir WP_DEBUG como verdadeiro. Guarde as suas alterações.

Em seguida, verá um novo botão na parte superior do seu painel. Passe o cursor sobre Debug Quick Look e clique em View File.

Isto abre o registo de depuração numa nova janela. Pode verificar se existem erros e corrigi-los rapidamente.

Os plug-ins de depuração oferecem uma introdução suave ao mundo da resolução de problemas do WordPress. São perfeitos para principiantes ou para verificações rápidas do desempenho do seu site. À medida que se sentir mais confortável com a depuração, poderá querer explorar alguns dos métodos mais avançados que abordaremos a seguir.

Lembre-se de que, embora esses plug-ins sejam incrivelmente úteis, eles podem adicionar alguma sobrecarga ao seu site. É melhor desactivá-los quando não estiver a fazer uma depuração ativa, especialmente num site ativo.

Método 2. Ativar manualmente a depuração do WordPress

Pronto para melhorar as suas capacidades de depuração? Também pode ativar manualmente o modo de depuração. Este método permite-lhe ter mais controlo e uma visão mais clara do que está a acontecer nos bastidores.

Antes de começar, recomendo que faça uma cópia de segurança do seu site. Vai fazer alterações aos ficheiros do seu site, por isso é melhor prevenir do que remediar!

Agora, terá de aceder aos seus ficheiros. Pode fazê-lo através do gestor de ficheiros do seu fornecedor de alojamento (como o cPanel) ou de um cliente FTP. 

Depois de ligar o seu sítio, abra o diretório raiz do WordPress(public_html). Localize o ficheiro wp-config.php.

Abra este ficheiro num editor de texto. Desloque-se para baixo até à linha que diz É tudo, pare de editar! Feliz publicação. (Se estiver a utilizar uma versão mais antiga, como o WordPress 5.0, dirá Feliz blogue em vez disso).

Acrescente estas linhas imediatamente antes:

define( 'WP_DEBUG', true);

define( 'WP_DEBUG_LOG', true);

define( 'WP_DEBUG_DISPLAY', false );

Vamos analisar o que cada um deles faz:

• WP_DEBUG: Ativa o modo de depuração do WordPress.
• WP_DEBUG_LOG: Isto guarda todos os erros num ficheiro debug.log no seu diretório wp-content.
• WP_DEBUG_DISPLAY: Isto evita que os erros sejam mostrados no front end do seu site.

Guarde as alterações e carregue o ficheiro de volta para o seu servidor.

O WordPress irá agora registar todos os erros, avisos e notificações no ficheiro debug.log. Pode aceder a este ficheiro para ver o que se passa nos bastidores do seu site.

Método 3. Utilizar a depuração de scripts

O problema que está a tentar resolver pode não estar no seu código PHP, mas nos seus scripts do WordPress. É aí que o SCRIPT_DEBUG se torna útil. 

O Script Debug é uma constante que força o WordPress a utilizar as versões completas dos principais ficheiros CSS e JavaScript em vez das versões reduzidas que são utilizadas por predefinição. É particularmente útil para programadores de temas e plug-ins, ou quando está a lidar com problemas de JavaScript e CSS. 

Tal como no método anterior, terá de aceder ao seu ficheiro wp-config.php.

Acrescentar esta linha:

define( 'SCRIPT_DEBUG', true );

Em seguida, guarde e volte a carregar o ficheiro.

Se houver um erro, obterá um número de linha mais preciso e uma mensagem de erro mais clara. Isto deve-se ao facto de os scripts não-minificados serem mais fáceis de ler e depurar. Pode percorrer o código linha a linha, facilitando a localização de um problema.

Tenha em mente que scripts não-minificados podem tornar seu site mais lento, portanto, use SCRIPT_DEBUG apenas quando estiver depurando ativamente. Desligue-o sempre num site ativo quando tiver terminado.

Método 4. Ativar o registo de consultas da base de dados

Por vezes, a culpa dos erros do WordPress está nas consultas à base de dados. Interações lentas ou problemáticas com a base de dados podem afetar significativamente o desempenho do seu sítio. 

É aí que o registo de consultas à base de dados se torna útil. Pode utilizar a constante SAVEQUERIES para guardar informações sobre todas as consultas à base de dados que são executadas na sua página. Isso inclui:

• A própria consulta SQL
• Quanto tempo demorou a consulta a ser executada
• Que funções chamaram a consulta

Para ativar a constante SAVEQUERIES, adicione esta linha ao seu ficheiro wp-config.php:

define( 'SAVEQUERIES', true );

Ao contrário de outros métodos de depuração, o SAVEQUERIES não apresenta automaticamente os seus resultados. Terá de adicionar algum código ao seu tema para ver os dados. 

Adicione este código ao ficheiro footer.php do seu tema (lembre-se de o remover quando terminar a depuração):

<?php

if ( current_user_can( 'administrator' ) ) {

 global $wpdb;

 echo "<pre>";

 print_r( $wpdb->queries );

 echo "</pre>";

}

?>

Isto apresentará as informações da consulta na parte inferior das suas páginas.

Método 5. Verificar se há erros de PHP

Ao ativar o relatório de erros do PHP, pode detetar erros que podem não ser visíveis através das ferramentas de depuração incorporadas no WordPress.

Utilize este método de depuração apenas num ambiente de desenvolvimento. Ele exibirá quaisquer erros no front-end, que você não quer que apareçam no seu site ativo.

Primeiro, terá de encontrar o seu ficheiro php.ini. Pode fazer isso com o Duplicator! Vá para Duplicator Pro " Ferramentas. Encontrará o caminho para o ficheiro php.ini nas Definições do servidor e Informações do PHP.

Também pode criar um novo ficheiro no diretório raiz do WordPress e chamar-lhe phpinfo.php. Adicione este código a ele:

<?php phpinfo(); ?>

Aceda a este ficheiro através do seu browser (por exemplo, yourdomain.com/phpinfo.php). Isto mostrar-lhe-á a sua configuração do PHP.

Na saída do phpinfo, procure a entrada Loaded Configuration File (Arquivo de configuração carregado ). Isto diz-lhe onde está localizado o seu ficheiro php.ini.

Abra o seu ficheiro php.ini e procure o seguinte código:

error_reporting = E_ALL

display_errors = On

Se não estiverem lá, adicione-os. Se estiverem lá, mas definidos com valores diferentes, altere-os para corresponderem ao código acima.

Se não tiver acesso ao php.ini, pode adicionar estas linhas ao seu ficheiro.htaccess:

php_value error_reporting E_ALL

php_flag display_errors on

Ou, adicione isto ao topo do seu ficheiro wp-config.php:

ini_set('display_errors', 1);

ini_set('display_startup_errors', 1);

ini_set('error_reporting',E_ALL);

Alguns anfitriões não permitem que altere as suas definições de PHP. Neste caso, poderá ser necessário contactar o seu anfitrião para obter assistência.

Método 6. Verificação de doing_it_wrong()

O WordPress tem uma função única chamada _doing_it_wrong() que pode ser incrivelmente útil para desenvolvedores e proprietários de sites. Esta função é a forma que o WordPress tem de lhe dizer que não está a utilizar algo corretamente.

Primeiro, certifique-se de que tem o WP_DEBUG ativado no seu ficheiro wp-config.php.

Com a depuração activada, o WordPress passa a mostrar-lhe mensagens quando detecta uma utilização incorrecta de funções ou APIs.

Estas mensagens têm normalmente o seguinte aspeto:

Warning: {function_name}() was called incorrectly. {message} in {file} on line {line_number}

A função doing_it_wrong() fornece informações valiosas como:

• O nome da função que está a ser utilizada incorretamente
• Uma mensagem a explicar o que está errado
• O ficheiro e o número da linha em que o problema ocorre

Se estiver num plug-in ou tema desenvolvido por si, actualize o seu código para utilizar o método correto. Se estiver num plug-in ou tema de terceiros, comunique o problema ao programador.

Nem todas as mensagens doing_it_wrong() indicam erros críticos, mas todas elas merecem ser abordadas. Sempre teste cuidadosamente após fazer alterações com base nessas mensagens.

11 dicas de especialistas para depuração do WordPress

Vamos mergulhar em algumas estratégias de depuração de nível profissional. Estas dicas ajudá-lo-ão a tornar-se um solucionador de problemas mais eficiente e eficaz, poupando-lhe tempo e dores de cabeça a longo prazo.

1. Rever os ficheiros de registo de erros

Normalmente, o WordPress guarda os registos de erros no diretório wp-content. Procure um ficheiro chamado debug.log. Se não o encontrar, poderá ter de o criar manualmente ou verificar com o seu fornecedor de alojamento a localização correta.

Cada entrada no registo segue normalmente este formato:

[Date and Time] PHP Error level: Error message in /path/to/file.php on line X

Ao rever os registos, preste atenção a:

• Erros recorrentes: Estão a ocorrer repetidamente determinados problemas?
• Tempo de ocorrência dos erros: Os problemas ocorrem em momentos específicos ou após determinadas acções?
• Gravidade dos erros: Concentre-se primeiro nos erros críticos e nos avisos.

Se estiver a depurar um problema específico, limpe o ficheiro de registo antes de reproduzir o problema. Desta forma, só verá os erros relevantes relacionados com o problema atual.

2. Utilizar um local de preparação

Uma das regras fundamentais da depuração do WordPress é: nunca depurar num site ativo. É aí que entram os sites de teste. 

Um site de teste permite-lhe depurar e experimentar sem o stress de danificar o seu site ativo. Trata-se de uma cópia exacta do seu sítio Web que se encontra numa área de testes privada e segura.

Quer esteja a resolver um erro complicado ou a testar uma grande remodelação do site, o seu ambiente de teste é o local perfeito para o fazer. É um investimento que compensa em termos de estabilidade e tranquilidade do sítio.

Muitos fornecedores de alojamento oferecem a criação de sítios de teste com um clique. Também é possível configurar um ambiente de desenvolvimento local. 

Eis alguns conselhos que aprendi com a utilização de sítios de teste:

1. Sincronize regularmente o seu site de teste com o seu site ativo para garantir que está a testar uma versão actualizada.
2. Preencha o seu sítio de teste com o conteúdo real do seu sítio ativo para obter testes mais precisos.
3. Proteja o seu site de teste com uma palavra-passe para o manter afastado de olhares curiosos e dos motores de busca.
4. Utilize o seu site de teste para testar actualizações, novos plug-ins e alterações de temas antes de os aplicar ao seu site ativo.
5. Mantenha um registo do que foi alterado no site de teste, para que possa replicar facilmente as correcções bem sucedidas no seu site ativo.

Configure um fluxo de trabalho em que todas as alterações passem pela fase de teste antes de chegarem ao sítio ativo. Isto pode detetar muitos problemas antes de estes chegarem aos seus utilizadores.

3. Verificar a configuração do servidor

O seu servidor é o motor que alimenta o seu sítio WordPress. Ele precisa das configurações certas para funcionar sem problemas. 

O ficheiro .htaccess desempenha um papel crucial na forma como o seu sítio interage com o servidor. Pode conter regras para coisas como permalinks (URLs personalizados) e reescritas. Certifique-se de que o seu ficheiro .htaccess está configurado corretamente, especialmente se tiver feito alterações recentemente.

O WordPress tem requisitos específicos de versão do PHP. Verifique a versão PHP do seu servidor e certifique-se de que cumpre a versão mínima recomendada para a sua instalação atual do WordPress. Versões desatualizadas do PHP podem levar a problemas de compatibilidade e vulnerabilidades de segurança.

Por vezes, os erros podem ter origem no próprio servidor. Se os métodos de depuração não resolverem o problema, considere a possibilidade de contactar o seu fornecedor de alojamento para obter mais assistência. Eles podem ajudar a diagnosticar quaisquer problemas específicos do servidor que possam estar a afetar o seu site.

4. Procurar ferramentas de desenvolvimento

O seu navegador Web inclui um poderoso conjunto de ferramentas de depuração. Aprender a utilizá-las eficazmente pode aumentar significativamente as suas capacidades de depuração do WordPress. 

Muitos programadores utilizam extensões de browser como o Chrome DevTools ou o Firefox Developer Tools. Estas ajudam-no a resolver problemas no front end do seu sítio.

Eis o que pode fazer com estas ferramentas:

• Inspecionar HTML, CSS e JavaScript a partir de um navegador da Web
• Analisar pedidos e respostas HTTP
• Modificar a estrutura HTML ou o estilo CSS
• Passo a passo da execução do código
• Definir pontos de paragem
• Identificar os recursos lentos
• Encontrar estrangulamentos no desempenho
• E muito mais!

Para o ajudar na sua jornada para se tornar um especialista, encontrámos as melhores ferramentas de desenvolvimento WordPress para si!

5. Utilizar WP_CLI

O WP-CLI (WordPress Command Line Interface) oferece uma forma poderosa e eficiente de depurar o seu sítio WordPress. É uma ferramenta que lhe permite interagir com a sua instalação do WordPress diretamente através de comandos.

Com o WP-CLI, você simplificará seu fluxo de trabalho de solução de problemas. Executar comandos pode ser muito mais rápido do que editar ficheiros ou utilizar o painel de administração. Também é possível automatizar tarefas repetitivas ou criar scripts personalizados para necessidades específicas de depuração.

Se você é novo no WP-CLI, não se preocupe! Aqui está uma rápida introdução.

Uma vez instalado, pode navegar para o seu diretório WordPress utilizando a linha de comandos e executar comandos WP-CLI. Estes comandos começam normalmente por wp seguido de uma ação específica (por exemplo, wp user list). 

Aqui estão alguns comandos de depuração úteis para o ajudar a começar:

• wp db check: Verifica a integridade da base de dados do WordPress.
• estado do plugin wp: Lista todos os plugins WordPress instalados e o seu estado atual (ativo, inativo, etc.).
• estado do tema wp: Lista todos os temas instalados e o seu estado atual.
• Registo de depuração do wp: Apresenta o conteúdo do ficheiro de registo de depuração do WordPress.

Estes são apenas alguns exemplos. A documentação oficial fornece uma lista completa e explicações detalhadas para cada comando.

Lembre-se que a utilização eficaz do WP-CLI requer alguma familiaridade com a linha de comandos. No entanto, a sua eficiência e poder fazem dele uma ferramenta valiosa para utilizadores experientes que pretendam acelerar o seu processo de depuração.

6. Ativar a depuração apenas temporariamente

Embora o WP Debug seja uma ferramenta poderosa, é importante lembrar que não se destina a uso permanente. 

O modo de depuração pode potencialmente abrandar os tempos de carregamento da página. Isto deve-se ao facto de apresentar mensagens de erro detalhadas e registar informações que não são necessárias para o funcionamento normal.

Deixar a depuração activada num site ativo expõe informações sensíveis, como mensagens de erro e consultas à base de dados. Estas informações podem ser potencialmente exploradas por hackers.

Por isso, é importante ativar a depuração temporariamente apenas quando estiver a resolver ativamente um problema. Aqui estão algumas práticas recomendadas:

1. Depois de implementar uma correção, desactive a depuração removendo o fragmento de código relevante do seu ficheiro wp-config.php (para depuração manual) ou desactivando o plug-in de depuração.
2. Idealmente, utilize um sítio de teste para depuração. Pode experimentar livremente os métodos de depuração sem sobrecarregar o seu sítio ativo.
3. Estabeleça um fluxo de trabalho claro para a depuração. Isto pode envolver a ativação da depuração, a análise dos registos e das mensagens de erro, a resolução do problema e, por fim, a desativação da depuração novamente.

Se seguir estas diretrizes, poderá solucionar problemas sem comprometer o desempenho ou a segurança do seu sítio. 

7. Não use muitos plug-ins de depuração

Os plug-ins de depuração oferecem uma maneira conveniente de ativar a depuração no WordPress. No entanto, há uma potencial desvantagem em confiar em demasiados deles.

Cada plug-in adiciona código e recursos ao seu site. Ter mais do que um plug-in de depuração em execução em simultâneo pode abrandar o desempenho do seu sítio Web.

Diferentes plug-ins de depuração podem ter funcionalidades que se sobrepõem. Isto pode dar origem a conflitos e comportamentos inesperados no seu sítio.

Eis uma abordagem mais estratégica à utilização de plug-ins de depuração:

• Identificar as suas necessidades

Antes de instalar um plug-in de depuração, defina claramente o problema que está a tentar resolver. Pesquise plug-ins que atendam a essa necessidade específica.

• Comece com um único plugin

Instale um plug-in de depuração bem revisto, conhecido pela sua fiabilidade e facilidade de utilização. As opções populares incluem Query Monitor, Debug Bar e WP Debugging.

• Desativar caraterísticas não utilizadas

Muitos plug-ins de depuração oferecem uma variedade de recursos. Desactive qualquer um que não esteja a utilizar atualmente para minimizar o consumo de recursos.

8. Usar um tema filho

Os temas filhos oferecem uma forma segura e eficaz de modificar a funcionalidade e o aspeto do seu tema sem editar diretamente os ficheiros do tema. Isto torna-se particularmente útil para a depuração de problemas relacionados com o tema.

Uma vez que faz alterações no tema filho, os ficheiros do tema original permanecem intactos. As novas actualizações de temas não substituem as suas personalizações.

Se encontrar um problema relacionado com o código do seu tema, pode concentrar os seus esforços de depuração nos ficheiros do tema filho. Isto simplifica a resolução de problemas ao isolar a potencial fonte do problema.

A utilização de um tema filho permite-lhe manter uma base de código separada para as suas personalizações. Isto facilita o controlo das alterações, a reversão para versões anteriores, se necessário, e a colaboração com outros programadores.

Antes de começar a resolver o problema, veja como criar o seu primeiro tema filho.

9. Implementar o controlo de versões

Efectuou alterações significativas ao seu site WordPress, apenas para encontrar um problema crítico mais tarde. Não seria útil voltar atrás no tempo e reverter para uma versão anterior? 

O controlo de versões permite-lhe acompanhar todas as alterações efectuadas aos ficheiros do seu sítio WordPress ao longo do tempo. Isto cria um histórico das revisões do seu sítio.

Se encontrar problemas após modificações no código, pode facilmente reverter para uma versão estável anterior. Isto pode ser um salva-vidas se algo correr mal durante o desenvolvimento ou a depuração.

Ao analisar as alterações feitas entre as diferentes versões, pode identificar a modificação exacta que pode ter introduzido um erro. O processo de depuração será significativamente simplificado.

O Git é amplamente utilizado para o controlo de versões do WordPress. Recomendo que comece por aqui se quiser gerir as alterações ao seu código.

10. Manter o WordPress atualizado

A depuração de um problema num site WordPress desatualizado pode ser como perseguir um alvo em movimento. As actualizações regulares garantem que está a trabalhar com a versão estável mais recente, tornando a depuração mais eficiente e fiável.

Ao seguir uma rotina de atualização consistente, pode manter um site WordPress seguro, estável e funcional. É menos provável que encontre problemas que exijam uma depuração extensiva, poupando-lhe tempo a longo prazo.

11. Colaborar e procurar ajuda

Mesmo os programadores WordPress experientes enfrentam desafios que exigem apoio adicional. Nunca deve ter medo de fazer perguntas e aprender com outras pessoas da sua área. 

Muitos fóruns em linha são dedicados à resolução de problemas do WordPress. Pode descrever o seu problema de depuração, partilhar mensagens de erro e obter informações valiosas de outros utilizadores e programadores. 

O WordPress Stack Exchange é uma mina de ouro para questões relacionadas com o WordPress. Procure soluções existentes para o seu problema ou publique uma pergunta detalhada para obter assistência da comunidade.

Também pode encontrar suporte dedicado para temas e plug-ins em WordPress.org. Se estiver a encontrar um problema com um plug-in ou tema específico, publique no fórum de suporte para obter orientação sobre a resolução de problemas.

Se for proprietário de um sítio Web com experiência técnica limitada, considere contratar um programador WordPress profissional. Eles podem analisar o seu problema, identificar a causa raiz e implementar uma solução, poupando-lhe tempo e esforço valiosos.

Perguntas frequentes sobre a depuração do WordPress

Conclusão

Com as ferramentas e os conhecimentos certos, pode resolver problemas de forma eficaz e manter um sítio WordPress saudável!

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

• Como limpar um site WordPress
• O que fazer quando o acesso ao WordPress é bloqueado
• Como corrigir o ecrã branco da morte do WordPress
• 8+ Melhores plug-ins de segurança do WordPress (escolha do especialista)
• Como corrigir o erro interno do servidor 500

Pretende repor rapidamente o seu site após um erro ou erro de resolução de problemas? Actualize para o Duplicator Pro para restauros com um clique e recuperação fácil de desastres!