Aprender a depurar um erro do WordPress

Um ecrã em branco ou uma resposta 500 não identifica por si só a causa: a falha pode vir do PHP, do WordPress, do servidor web ou de uma dependência. Comece pelo registo associado ao pedido e à hora exata do erro, sem o atribuir ainda a um plugin ou a uma alteração recente.

Faça o teste de preferência numa cópia de staging. Se tiver de o reproduzir em produção, mantenha display_errors desativado e envie os erros para um registo privado fora de public_html, seguindo o guia para depurar erros no WordPress.

Se o WordPress mostrar a mensagem de erro crítico, reveja primeiro o email da conta de administrador. Desde o WordPress 5.2, a ligação do Modo de recuperação permite aceder com o plugin ou tema problemático em pausa para essa sessão.

Reproduza apenas a operação que falha e consulte imediatamente o registo. Neste exemplo aparece o seguinte erro fatal:

Fatal error: require(): Failed opening required 
'/home/user/public_html/wp-content/plugins/woocommerce/src/Packages.php' 
(include_path='.:/opt/alt/php74/usr/share/pear') 
in /home/user/public_html/wp-content/plugins/woocommerce/woocommerce.php on line 25

A mensagem demonstra que require não conseguiu abrir este ficheiro:

public_html/wp-content/plugins/woocommerce/src/Packages.php

e que a chamada foi feita a partir da linha 25 de:

public_html/wp-content/plugins/woocommerce/woocommerce.php

Isto situa a falha durante o carregamento do WooCommerce, mas não demonstra por si só que o plugin esteja danificado nem porque é que o ficheiro não pôde ser aberto. Reveja também o aviso anterior a Failed opening required, que costuma indicar se o ficheiro não existe, não é legível ou está bloqueado por uma restrição de caminho. Verifique a sua existência, maiúsculas e minúsculas, permissões, proprietário e correspondência com a versão instalada.

Se o ficheiro faltar realmente e o erro tiver aparecido durante uma atualização, uma instalação incompleta é uma hipótese compatível com a evidência. Para recuperar temporariamente o acesso, use primeiro o Modo de recuperação ou mude o nome de wp-content/plugins/woocommerce; não elimine o diretório antes de conservar uma cópia para a análise.

Depois pode reinstalar a mesma versão ou uma versão compatível a partir de uma fonte oficial. Restaure o diretório a partir de uma cópia de segurança apenas se a cópia for anterior à falha, for considerada limpa e for compatível com o estado atual da base de dados.

Recuperar a loja e verificar a encomenda completa

O rastreio é um exemplo histórico: o caminho php74 não recomenda utilizar o PHP 7.4. Use a versão compatível e mantida que corresponda ao seu WooCommerce atual.

Enquanto o WooCommerce estiver em pausa, a loja pode perder funções de compra. Conserve as encomendas recentes e evite restaurar uma base de dados antiga só para recuperar um ficheiro do plugin. Depois de reparar os ficheiros, verifique o catálogo, o carrinho, o início da compra e a notificação de pagamento num ambiente de teste. Se instalar uma versão que migra a base de dados, planeie também a compatibilidade da reversão; copiar depois uma pasta antiga não desfaz essa migração.