Depurar erros no WordPress

O WordPress permite configurar a depuração em wp-config.php. Para investigar uma falha num site público, envie os detalhes para um registo privado e mantenha oculta a apresentação de erros.

Faça estes testes de preferência numa cópia de staging. Em produção, não mostre erros no ecrã: podem revelar caminhos, consultas e dados internos a qualquer visitante.

Registar os erros sem os mostrar

Crie um diretório de registos fora de public_html, certifique-se de que o PHP consegue escrever nele e aplique a permissão 0600 ao ficheiro quando o sistema o permitir. Acrescente temporariamente estas linhas a wp-config.php, substituindo CPANEL_USUARIO. Coloque-as antes de ser carregado wp-settings.php, normalmente antes do comentário que indica para parar de editar. Se alguma constante já existir, altere o seu valor em vez de a declarar uma segunda vez:

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', false);
define('WP_DEBUG_LOG', '/home/CPANEL_USUARIO/logs/wordpress-debug.log');
@ini_set('display_errors', '0');

Não use wp-content/debug.log num site público, a menos que o servidor bloqueie expressamente o seu descarregamento. Reproduza a falha uma única vez, anote a hora e conserve o primeiro erro desse pedido com algumas linhas de contexto. Verifique que não contém palavras-passe, tokens nem dados pessoais antes de partilhar excertos.

Vejo um ecrã em branco

Se o registo do WordPress não apanhar a falha, ative temporariamente o registo do PHP a partir do cPanel e consulte a mesma hora, ou peça ao suporte que o reveja. Mantenha sempre display_errors desativado em produção.

Desativar e limpar

Ao terminar, restaure os valores anteriores de WP_DEBUG, WP_DEBUG_LOG e WP_DEBUG_DISPLAY, retire a linha temporária de ini_set e apague o ficheiro quando já não for necessário. A depuração não deve ficar ativa indefinidamente em produção.

Se não aparecer a entrada esperada

Verifique que editou o wp-config.php utilizado por essa instalação e que o PHP consegue escrever no caminho escolhido. Use os valores booleanos true e false sem aspas: o texto 'false' não equivale ao booleano falso.

WP_DEBUG alarga os níveis de erro e pode gerar muitos avisos que não causam a falha. Relacione o primeiro erro relevante com o pedido e a sua hora. Se houver um erro de sintaxe antes de o WordPress carregar estas opções, consulte o registo PHP do servidor. O guia oficial de depuração detalha o alcance de cada constante.