Saltar para o conteúdo 
O Modo de depuração do WordPress permite que os administradores e os programadores identifiquem rapidamente as fontes de erros e as rectifiquem de forma orientada. Aqueles que o configuram e utilizam corretamente poupam muito tempo na resolução de problemas e aumentam significativamente a fiabilidade operacional do seu sítio Web.
Pontos centrais
- Ativação possível através de wp-config.php ou plugin
- Registos de erros analisar e interpretar de forma orientada
- Opções de depuração como utilizar WP_DEBUG_LOG & SAVEQUERIES eficazmente
- Ferramentas como o Query Monitor fornecem informações mais detalhadas
- Hospedagem desempenha um papel decisivo nos processos de depuração
Muitos utilizadores do WordPress só utilizam o modo de depuração quando ocorre um problema grave. No entanto, quanto mais experiência se adquire com ele, mais vale a pena activá-lo na fase de desenvolvimento ou de teste, de modo a excluir antecipadamente potenciais fontes de erro. Eu próprio já experimentei dezenas de vezes como é possível implementar mais rapidamente actualizações e novas funcionalidades com informações de depuração.
O que é que o Modo de Depuração do WordPress faz realmente?
O modo de depuração apresenta Fontes de erro visível. Fornece informações cruciais, nomeadamente em caso de comportamento inexplicável do sítio ou de interrupções súbitas. Quem são WP_DEBUG_LOG ativado, todas as notas do ficheiro wp-content/debug.log podem ser registados automaticamente. Isto é útil se não quiser mostrar diretamente as mensagens de erro mas quiser documentá-las de forma segura. As causas de problemas de desempenho, conflitos de plug-ins ou comandos desactualizados podem ser eficazmente rastreados através da análise deste ficheiro.
Outra vantagem é a transparência no que respeita aos erros, avisos e avisos menores do PHP. Porque nem todas as avarias terminam com um ecrã branco ou uma mensagem de erro direta no frontend. Por vezes, alguns erros nem sequer são notados antes de todo o sítio ir abaixo - por exemplo, devido a uma atualização. Nesses casos, um modo de depuração bem configurado é quase inestimável. Para mim é sempre reconfortante saber que o meu wp-config.php está corretamente configurado e que posso aceder aos ficheiros de registo, se necessário. Isto significa que dificilmente me escapa qualquer mensagem de erro oculta.
Como ativar corretamente o modo de depuração do WordPress
A forma mais eficaz de ativar o modo é diretamente através do wp-config.php. Este método torna-o independente dos plugins e é particularmente flexível. Certifique-se de que o ativa antes da linha "That's all, stop editing!". A combinação da desativação da apresentação no frontend e da escrita no ficheiro de registo também impede que dados potencialmente sensíveis sejam apresentados aos visitantes do sítio.
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);
Em alternativa, um plugin como o Depuração WP pronto. Simplifica o processo para os utilizadores menos experientes em tecnologia e oferece funções adicionais, por exemplo, juntamente com o Monitor de consultas. É importante para ambas as variantes: É melhor fazer uma cópia de segurança da sua base de dados e dos ficheiros de configuração antes de ativar a função de depuração.
Trabalhar com plugins é muitas vezes mais intuitivo, especialmente para principiantes. Ao mesmo tempo, é possível manter-se a par das actualizações sem ter de mexer manualmente no wp-config.php. Na minha experiência, experimentar a variante de plug-in num ambiente de teste ou de desenvolvimento local provou ser uma boa ideia. Isto permite-lhe testar com segurança se as informações de depuração são apresentadas como pretendido e se todas as definições funcionam corretamente. Só depois é que eu tomaria estas medidas num ambiente real - e mesmo aí só durante o tempo que fosse realmente necessário. Nada é mais desagradável do que a fuga inadvertida de dados sensíveis.
Estes parâmetros de depuração ajudá-lo-ão a
O WordPress reconhece vários Opções de depuraçãoque são importantes, dependendo da situação da aplicação. Pode utilizar o wp-config.php para controlar especificamente o âmbito do registo de erros. Deve conhecer algumas das opções mais pormenorizadamente:
| Opção | Descrição | Quando utilizar? |
|---|---|---|
WP_DEBUG | Ativa a mensagem de erro global | Para desenvolvimento ou resolução de problemas |
WP_DEBUG_LOG | Regista os erros de forma segura no ficheiro de registo | Recomendado para sítios activos |
WP_DEBUG_DISPLAY | Mostra mensagens de erro no frontend | Utilizar APENAS localmente |
SCRIPT_DEBUG | Carrega scripts não minimizados | Para testar novas funcionalidades JS ou CSS |
POUPARQUÉRIES | Regista as consultas SQL em pormenor | Análise de desempenho durante o desenvolvimento |
A opção WP_DEBUG constitui a base: sem ele, os outros parâmetros nem sequer têm efeito. Assim que começar a trabalhar no desempenho e na compatibilidade numa instalação de desenvolvimento local, vale a pena POUPARQUÉRIESpara controlar as consultas à base de dados, se necessário. Para mim, isto é uma necessidade, especialmente quando um novo plugin causa muitos acessos adicionais à base de dados. Assim, posso ver exatamente quais as consultas que estão a causar problemas no registo e posso reagir, se necessário.
Também faz sentido SCRIPT_DEBUG se ocorrerem problemas de CSS ou JavaScript. Os ficheiros minimizados ou comprimidos são bons para o desempenho, mas tornam a resolução de problemas mais difícil porque são pouco legíveis. Com SCRIPT_DEBUG por outro lado, utiliza a versão descomprimida e pode localizar todos os conflitos diretamente. Recomendo-o particularmente aos principiantes que utilizam glossários, construtores de páginas ou temas complexos e que se interrogam porque é que o Safari reage de forma ligeiramente diferente do Chrome.
Analisar eficazmente o ficheiro debug.log
Depois de ativar WP_DEBUG_LOG, o WordPress escreve todos os dados detectados Mensagem de erro no ficheiro debug.log. Pode encontrar o caminho em wp-content/debug.log. As entradas contêm, entre outras coisas, carimbos de data e hora, fontes e tipos de mensagens. Particularmente valiosas são as referências a "Funções obsoletas" ou argumentos passados incorretamente. Se aparecerem linhas de erro idênticas várias vezes, é frequente haver um problema de plugin ou tema por detrás disso.
Trabalhe de forma estruturada durante a análise: Anote o período de tempo do erro e, em seguida, verifique as alterações efectuadas em plug-ins, temas ou código personalizado. Isto ajudá-lo-á a identificar a causa de forma eficaz. Especialmente no caso de avisos que se repetem com frequência, vale a pena procurar especificamente padrões ou correlações com determinadas acções dos visitantes. Também procuro nos registos do servidor ou utilizo ferramentas de depuração para recolher quaisquer pistas.
Em alguns casos, o ficheiro debug.log mostra apenas avisos superficiais que não afectam necessariamente a função. No entanto, não se deve simplesmente ignorar estes avisos, pois podem ser uma indicação de que um tema ou parte de um plugin está desatualizado. Estes "avisos" e "notificações" fornecem frequentemente informações antecipadas sobre uma alteração iminente da versão do PHP utilizada ou sobre uma função que irá expirar num futuro próximo. Já tive a experiência de um plugin que utilizou funções desactualizadas durante meses, o que só se tornou um problema quando o servidor foi alterado.
Também é aconselhável introduzir uma rotina de verificação de registos em equipas maiores. Por exemplo, pode dar uma vista de olhos rápida ao debug.log após cada atualização importante e documentar quaisquer anomalias. Isto reduz o risco de erros que só se tornam aparentes quando já é demasiado tarde. Isto não só cria mais estabilidade, como também aumenta a confiança na sua própria infraestrutura.
Resolução de problemas: cenários típicos da prática
Uma configuração de depuração funcional dá-lhe vantagens decisivas no caso de erros específicos. Se um plugin deixar de funcionar corretamente após uma atualização, o ficheiro de registo geralmente mostra imediatamente a pessoa responsável. Isto permite que as extensões sejam especificamente identificadas e desactivadas para fins de teste.
Noutros casos, estão a ser utilizados comandos PHP desactualizados. Você pode reconhecê-los através de avisos sobre os chamados funções obsoletas. Procure uma versão mais actualizada da extensão - ou substitua-a. Se as mensagens de erro também ocorrerem com plug-ins desactivados, a utilização de um tema padrão, como o Twenty Twenty-Three, ajuda a isolar os erros.
Qualquer pessoa que tenha trabalhado com o WordPress durante algum tempo também estará familiarizada com o fenómeno do "ecrã branco da morte". De repente, só se vê uma página branca quando se acede ao sítio - sem qualquer mensagem de erro. Nestes casos, pessoalmente, acho que a combinação de WP_DEBUG, WP_DEBUG_LOG e WP_DEBUG_DISPLAY (este último, no entanto, apenas localmente). Verifico o debug.log para ver exatamente que linhas e que ficheiros desencadeiam o erro fatal. Uma intervenção rápida, como a desativação de um plugin ou a personalização de uma função de um tema, é muitas vezes suficiente para que o sítio Web volte a funcionar.
Por vezes, a causa reside nas extensões PHP necessárias que não estão activas ou não estão disponíveis. Estes problemas de compatibilidade surgem, especialmente quando se muda para um novo servidor ou com pacotes de alojamento web mais pequenos. Vale a pena estar atento tanto ao registo de erros do servidor como ao debug.log para obter informações completas. Recomendo que verifique o modo de depuração e os registos diretamente sempre que mudar de servidor - desta forma evita surpresas se, por exemplo, uma função importante como mbstring ou gd não estiver disponível.
Ferramentas profissionais para uma depuração aprofundada
Para além das próprias ferramentas integradas do WordPress, existem outras ferramentas que o ajudam a analisar os erros. Monitor de consultas visualiza consultas de bases de dados, pedidos HTTP, hooks e erros PHP diretamente no backend. Pode ver rapidamente quais as consultas que estão a correr demasiado devagar ou a gerar erros. Isto poupa tempo valioso na análise dos tempos de carregamento.
Com Barra de depuração pode adicionar uma visualização dos hooks activos, dos modelos actuais e dos registos actuais ao menu de administração. Se tiver acesso direto ao servidor, pode utilizar Xdebug definir pontos de paragem específicos e efetuar uma avaliação passo-a-passo de funções PHP individuais.
Já trabalhei com todas estas ferramentas e posso confirmar que funcionam perfeitamente em conjunto. O Query Monitor está constantemente a ser executado no meu ambiente de desenvolvimento. Assim que vejo que uma página está a demorar muito tempo a carregar ou que as minhas consultas SQL não estão a dar em nada, verifico as consultas registadas. A Debug Bar, por outro lado, é ideal para controlar rapidamente outras funções administrativas, tais como os ganchos que estão atualmente activos. O Xdebug é imbatível para erros particularmente complexos em que é necessário ir mais fundo no código. Posso percorrer o código linha a linha e descobrir exatamente onde o fluxo de valores ou a gestão de variáveis está a comportar-se de forma inesperada. Isto vale realmente o seu peso em ouro, especialmente com bases de código grandes e confusas.
Estas ferramentas são extremamente valiosas, especialmente num contexto de equipa. Não só se pode depurar passo a passo, como também se podem partilhar os resultados entre si. Desta forma, mesmo os membros menos experientes da equipa aprendem rapidamente a perceber onde se esconde um erro e como o reconhecer. O efeito de aprendizagem é imenso se as ferramentas forem utilizadas de forma consistente e se a lógica subjacente a cada mensagem de erro for explicada de forma transparente.
Depuração segura correta: O que é preciso evitar
Embora o modo de depuração seja útil, comporta riscos de segurança se for utilizado incorretamente. Em páginas activas, nunca deve Indicações de erro no frontend, uma vez que os caminhos de ficheiros sensíveis ou as funções internas podem tornar-se publicamente visíveis. Utilize apenas o ficheiro de registo e, se necessário, restrinja o acesso aos ficheiros no lado do servidor (por exemplo, através de .htaccess).
Além disso, os ficheiros de registo de depuração crescem rapidamente. Elimine ou mova os registos antigos para um diretório protegido quando a análise estiver concluída. Isto evitará volumes de dados desnecessários e possíveis falhas de segurança no futuro.
No meu trabalho diário, procuro verificar regularmente os ficheiros de registo e não os deixar acumular demasiados dados inúteis. Especialmente quando se gere um projeto há vários anos, é possível acumular muita coisa. As pessoas esquecem-se muitas vezes que os registos de depuração podem revelar informações úteis sobre a estrutura do projeto no caso de um ataque de hackers. Por isso, é importante tratar estes dados de forma responsável e não os deixar permanentemente acessíveis ao público.
Porque é que um bom alojamento simplifica a depuração
Um servidor rápido e estável facilita muito a depuração e a análise de erros. Fornecedor com Optimizado para WordPress Os ambientes permitem não só o acesso aos registos, mas também às estruturas de ficheiros, às definições de cache e aos níveis de erro. Especialmente se gerir vários sítios Web, vale a pena procurar ofertas de alojamento específicas que satisfaçam os requisitos de vários projectos WordPress ao mesmo tempo.
| Local | Fornecedor | Vantagens |
|---|---|---|
| 1 | webhoster.de | Alojamento SSD, suporte direto, ferramentas de depuração pré-instaladas |
| 2 | Fornecedor B | Cópias de segurança rápidas, registos alargados |
| 3 | Fornecedor C | Caraterísticas de segurança, interface flexível |
Com um suporte facilmente acessível e reativo, os problemas podem ser identificados ainda mais rapidamente em caso de dúvida. Os anfitriões que oferecem ferramentas de depuração pré-instaladas ou instruções claras para a configuração do WP_DEBUG poupam-lhe uma pesquisa fastidiosa. Eu próprio desenvolvi uma preferência por hosts que oferecem ambientes de servidor optimizados para o desempenho e que também têm um sistema de preparação no pacote. Aí pode executar a depuração num ambiente quase idêntico ao do sítio em funcionamento sem correr quaisquer riscos.
Além disso, os registos do lado do servidor, como o registo de erros do Apache ou do Nginx, são de enorme importância. Por vezes, é possível ver muito mais do que aquilo que o próprio WordPress regista. Uma análise adequada do problema não exclui, portanto, o nível de alojamento. Quaisquer mecanismos de cache, tarefas cron ou configurações de firewall só funcionam corretamente se as suas mensagens de erro puderem ser visualizadas, se necessário.
Dicas importantes para o dia a dia
Tomar o Análise de erros a sério. Registo todos os incidentes evidentes num registo separado. Isto permite-me manter uma visão geral e encontrar soluções para erros recorrentes mais rapidamente. Também testo sempre novos plugins num ambiente de teste para evitar problemas no sítio ativo.
Mantenha também os seus componentes WordPress actualizados: extensões desactualizadas dão frequentemente origem a avisos PHP ou erros SQL. Eu actualizo regularmente temas, plugins e o núcleo, mesmo que não haja uma razão urgente para o fazer. Isto porque uma atualização negligenciada contém muitas vezes vulnerabilidades de segurança e é uma causa frequente de conflitos, especialmente quando são utilizadas versões mais recentes do PHP.
Deve também limpar a sua instalação do WordPress: remova completamente os plugins e temas não utilizados em vez de os desativar apenas. As extensões antigas e não utilizadas contêm frequentemente componentes de código obsoletos que podem mais tarde causar mensagens de erro. Um inventário de código enxuto torna a depuração muito mais fácil porque tem menos fontes potenciais de problemas.
A versão do PHP também é crucial. Se ainda estiver preso a uma versão antiga, corre o risco de deixar de poder utilizar corretamente certas funções ou plugins do WordPress. Cada atualização do PHP não só traz novas funcionalidades, como também remove comandos (funções que foram rotuladas como "depreciadas"). Por isso, é aconselhável verificar num ambiente de teste se uma mudança de versão é possível sem problemas e se todos os temas e plugins são compatíveis. Um modo de depuração ajuda a reconhecer imediatamente onde ainda existem problemas.
Alguns problemas só surgem sob carga, por exemplo, quando vários utilizadores acedem a determinadas páginas ao mesmo tempo ou quando as tarefas cron se sobrepõem. Aqui pode ser útil não só registar esporadicamente, mas também a longo prazo e efetuar testes de carga. Especialmente se tiver um sítio Web ou uma loja em linha muito frequentados, pode reconhecer eficazmente estrangulamentos ou bloqueios na base de dados. Também recomendo documentar detalhadamente todas as alterações efectuadas nos parâmetros do sistema (por exemplo, Memory_Limit). Os pontos de interrupção no Xdebug ou as entradas de registo de depuração mostram então a carga exacta em que ocorre um erro.
Também deve haver uma divisão clara de papéis na equipa: quem testa o quê, quem documenta os resultados e quem altera o código? Uma boa comunicação ajuda a garantir que duas pessoas não fazem, inadvertidamente, configurações de depuração diferentes ao mesmo tempo. Já vi definições de depuração serem substituídas umas pelas outras porque ninguém sabia quem tinha acabado de alterar o parâmetro sob stress.
Conclusão: Reconhecer os erros, garantir o desempenho
O Modo de Depuração do WordPress é uma das ferramentas mais importantes para a resolução eficiente de problemas. Se o utilizar de forma direcionada, descobrirá vulnerabilidades mais rapidamente e garantirá que o seu sítio Web funciona sem erros a longo prazo. Ferramentas como o Query Monitor, registos seguros e intervenção imediata em caso de avisos são essenciais.
Recomendo a ativação do modo de depuração apenas em ambientes de desenvolvimento ou para a resolução de problemas graves. O ganho de conhecimento associado e a abordagem estruturada pouparão dias de trabalho e aborrecimento - especialmente no caso de erros súbitos. Além disso, a análise regular dos registos reduz o risco de vulnerabilidades de segurança e optimiza o desempenho ao mesmo tempo. Isto mantém o seu sítio Web estável e adaptado às necessidades futuras.
