Como ativar o modo de depuração (WP_DEBUG)
O que é o modo de depuração WP_DEBUG?
Ativar o debug no WordPress (a constante WP_DEBUG) significa ligar o modo de depuração definindo constantes no wp-config.php. Por padrão, o WordPress esconde os erros de PHP em produção por segurança, o que faz problemas aparecerem como tela branca, sem pista nenhuma. Com o WP_DEBUG ligado (e o WP_DEBUG_LOG), todo erro, aviso (warning) e notice passa a ser registrado em um arquivo de log, sem precisar ser mostrado ao visitante.
Como identificar
- O site mostra tela branca ou “There has been a critical error” sem dizer qual arquivo falhou.
- Você precisa achar qual plugin ou tema está causando um erro fatal e não há mensagem visível.
- Aparecem avisos de “Deprecated” ou “Undefined array key” intermitentes que você quer registrar.
- Um desenvolvedor pediu o conteúdo do wp-content/debug.log e o arquivo ainda não existe.
Como prevenir
- Use sempre WP_DEBUG_LOG com WP_DEBUG_DISPLAY false em produção, para depurar sem expor o site
- Desligue o WP_DEBUG e apague o debug.log assim que terminar o diagnóstico
- Em ambiente de staging, mantenha o debug ligado para flagrar avisos antes de subir para produção
Causa
- WP_DEBUG vem definido como false no wp-config.php padrão de produção, escondendo os erros.
- WP_DEBUG_LOG não está ativo, então nada é gravado em wp-content/debug.log.
- WP_DEBUG_DISPLAY ligado em produção exibiria o erro ao visitante, então é deixado desligado e o erro some da vista.
- A constante foi colocada depois da linha 'That's all, stop editing!', onde o WordPress já ignora.
- Um plugin de cache ou de segurança sobrescreve as constantes de debug.
Como resolver
- Abra o wp-config.php via FTP: conecte-se por FTP ou pelo gerenciador de arquivos da hospedagem e edite o wp-config.php na raiz do site.
- Ative o debug com log e sem exibir na tela: adicione as constantes ANTES da linha 'That's all, stop editing!'. Em produção, mantenha o DISPLAY como false para o erro ir só para o log:
define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false); @ini_set('display_errors', 0); - Reproduza o problema: abra a página ou execute a ação que gerava o erro. O WordPress grava a falha no log nesse momento.
- Leia o wp-content/debug.log: abra o arquivo wp-content/debug.log via FTP. A última entrada de 'Fatal error' aponta o arquivo e a linha do problema.
- Desligue o debug ao terminar: volte WP_DEBUG para false e apague o debug.log. Deixar o debug ligado em produção pode vazar caminhos do servidor para quem não deveria ver.
// wp-config.php — modo de depuracao seguro (antes de "That's all, stop editing!")
define( 'WP_DEBUG', true ); // liga o modo de depuracao
define( 'WP_DEBUG_LOG', true ); // grava em wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // NAO mostra o erro ao visitante
@ini_set( 'display_errors', 0 ); // reforca: nada na tela em producaoPerguntas frequentes
Ativar o WP_DEBUG deixa o site mais lento ou inseguro?
Onde fica o arquivo debug.log?
Liguei o WP_DEBUG mas nada acontece. Por quê?
Qual a diferença entre WP_DEBUG_LOG e WP_DEBUG_DISPLAY?
Posso ativar o debug sem mexer no wp-config.php?
Preciso desligar o WP_DEBUG depois de resolver?
Como corrigir Undefined array key no PHP 8 do WordPress
O Undefined array key é um aviso do PHP 8 que aparece quando o código tenta ler uma posição de um array que não existe, por exemplo um campo de formulário que não foi enviado. O site segue no ar, mas a mensagem aparece na tela ou enche o debug.log e indica que falta uma verificação no código.
Como corrigir Call to undefined function no WordPress
O Call to undefined function é um erro fatal de PHP que aparece quando o código chama uma função que não existe naquele ponto: ou o nome está errado, ou a extensão que a fornece está desativada, ou a função do WordPress foi chamada cedo demais. O site cai com erro fatal na página afetada.
Como corrigir Cannot redeclare function
O erro Cannot redeclare function é um erro fatal de PHP que ocorre quando a mesma função é definida duas vezes na execução. No WordPress, costuma surgir ao colar um snippet repetido no functions.php ou ao ativar dois plugins que declaram uma função com o mesmo nome.
Como corrigir Failed opening required no WordPress
O Failed opening required é um erro fatal de PHP que aparece quando o código manda incluir um arquivo (com require) que não existe no caminho informado, está com permissão negada ou foi apagado. O WordPress para na hora e a página não abre, geralmente após uma migração, uma atualização interrompida ou um plugin removido pela metade.
Como corrigir a incompatibilidade do Astra Pro com PHP 8.3
O erro de compatibilidade do Astra Pro com o PHP 8.3 acontece quando uma versão antiga do addon roda num servidor já no PHP 8.3, disparando avisos de deprecated ou um fatal error que derruba o front-end ou o Personalizar. A correção é alinhar tema, plugin Astra Pro e licença na versão mais recente.
Como corrigir Allowed memory size exhausted
O erro allowed memory size exhausted é um erro fatal de PHP que aparece quando um script do WordPress tenta usar mais memória do que o limite definido no servidor. O resultado é uma página em branco ou um aviso de erro fatal, geralmente disparado por um plugin pesado, importação de dados ou limite memory_limit baixo demais.
