WordPress debug: como identificar e resolver erros
Quando o WordPress mostra um ecrã branco, um erro 500 ou um comportamento inesperado, o primeiro passo é descobrir exatamente o que está errado. O modo debug do WordPress revela erros PHP, avisos e informações de diagnóstico que estão normalmente escondidos por razões de segurança.
Ativar o debug
Edite o ficheiro wp-config.php e altere ou adicione estas linhas:
Este exemplo é ilustrativo. Adapte domínio, caminhos e valores ao ambiente e teste numa cópia antes de aplicar. Não repita constantes já definidas nem regras geridas por outra ferramenta.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', '/CAMINHO_PRIVADO_FORA_DA_RAIZ_PUBLICA/wordpress-debug.log' );
define( 'WP_DEBUG_DISPLAY', false );WP_DEBUG: ativa o modo debug. Erros PHP são registados.
Configure registo num caminho protegido, quando suportado, e mantenha WP_DEBUG_DISPLAY desativado para visitantes. Logs podem conter dados sensíveis. Restrinja acesso, limite retenção e retire a configuração temporária depois da análise.
WP_DEBUG_DISPLAY: false para não mostrar erros no interface pública (segurança: nunca mostre erros PHP a visitantes).
Ler o log
Exemplo: PHP Fatal error: Allowed memory size of 134217728 bytes exhausted in /home/user/public_html/wp-includes/class-wpdb.php on line 2456: o limite de memória foi excedido. Solução: aumentar o memory_limit.
Exemplo: PHP Warning: call_user_func_array() expects parameter 1 to be a valid callback in /home/user/public_html/wp-content/plugins/meu-plugin/plugin.php on line 123: um plugin tem um problema na linha 123. Desactive o plugin ou contacte o developer.
Diagnosticar conflitos de plugins
Se o erro não indica claramente o plugin responsável: desactive todos os plugins (renomeie a pasta plugins para plugins_off via Gestor de Ficheiros), verifique se o problema desaparece. Se sim, reative os plugins um a um até o problema reaparecer: identificou o conflito.
Consulta Monitor
O plugin Consulta Monitor é a ferramenta de debug mais avançada para WordPress. Mostra consultas lentas à base de dados, hooks e filtros ativos, uso de memória por componente, erros PHP, e pedidos HTTP a APIs externas. Instale-o temporariamente quando precisa de diagnosticar problemas de performance ou conflitos.
Após resolver
Desactive o debug em produção: define( 'WP_DEBUG', false );. O ficheiro debug.log pode crescer rapidamente e conter informação sensível. Elimine-o após resolver o problema.
Recolher erros sem os mostrar ao público
Use registos protegidos e evite apresentar mensagens técnicas aos visitantes. Os logs podem conter caminhos, dados de pedidos ou informação pessoal. Defina localização, acesso e prazo de conservação.
Reproduza a falha com um caso simples e anote a hora. Um aviso PHP não é necessariamente a causa de um erro fatal; procure a sequência relevante. Depois da investigação, retire configurações temporárias e confirme que o ficheiro de log não está acessível publicamente nem cresce sem controlo.
Escolha a solução pensando em quem vai manter o site
A funcionalidade pode parecer simples no dia da instalação e tornar-se difícil de manter quando muda a equipa. Antes de escolher um tema, plugin ou método de edição, confirme se os conteúdos podem ser atualizados sem intervenção no código, como são tratados os estilos e se existem dependências de licenças ou ferramentas externas.
Teste a edição de uma página real, a visualização no telemóvel e a recuperação após uma atualização. Se o projeto exige integrações, tipos de conteúdo personalizados ou regras de acesso, documente essas necessidades antes de instalar várias extensões. Num projeto empresarial, a melhor opção não é necessariamente a que tem mais funcionalidades; é a que responde aos requisitos e pode ser mantida de forma previsível.
Quando o alojamento WordPress faz a diferença
Os planos WordPress da Lusitec combinam armazenamento NVMe, ferramentas de otimização e suporte técnico especializado. A escolha deve ter em conta plugins, base de dados, tráfego e dependências da aplicação. O alojamento adequado cria boas condições de funcionamento, mas a manutenção e a qualidade do próprio site continuam a ser essenciais.
Um plano de reversão evita transformar uma melhoria num incidente
Antes de atualizar o WordPress ou acrescentar funcionalidades, confirme uma cópia recuperável e registe o que vai mudar. Teste depois o menu, os formulários, o acesso administrativo e a utilização no telemóvel. Numa loja, inclua carrinho, pagamentos e notificações. Alterar vários plugins ao mesmo tempo dificulta perceber qual deles provocou uma incompatibilidade.
Se o projeto utiliza código personalizado, mantenha documentação das dependências. Um procedimento simples de validação após alterações pode evitar problemas que só seriam descobertos por clientes dias depois.
A influência do alojamento no WordPress
O WordPress executa PHP, consulta uma base de dados e descarrega imagens, estilos e scripts. A infraestrutura influencia a resposta e os recursos disponíveis, mas não elimina problemas num tema ou plugin. Antes de recomendar mais memória, confirme onde surge o atraso.
A Lusitec disponibiliza alojamento WordPress com armazenamento NVMe, ferramentas de otimização e suporte prioritário. Para escolher, descreva os plugins essenciais, o número de visitas e as integrações. O suporte técnico é especialmente útil para distinguir limitações de recursos de erros da aplicação.
Localizar o erro antes de alterar o site
Reúna registos e passos de reprodução e evite expor dados de diagnóstico aos visitantes.
Para alojar o projeto, consulte os nossos planos de alojamento WordPress. Podemos analisar as necessidades do site. Fale connosco se precisa de ajuda a escolher.