Manutenção · GUIA PRÁTICO

Como registrar erros do WordPress sem exibi-los aos visitantes

Configure diagnóstico temporário com log, limite a exposição de erros e desative o modo de depuração ao terminar a investigação.

O modo de depuração ajuda a localizar falhas, mas mensagens podem expor caminhos e informações internas. Em produção, a investigação deve registrar eventos sem mostrá-los ao público e ter prazo definido.

Antes de começar

Tenha acesso autorizado aos arquivos, backup do wp-config.php e janela de teste. Identifique onde o log será gravado, quem terá acesso e como será removido depois.

Passo a passo

  1. Faça cópia segura de wp-config.php e confira se já há constantes de debug duplicadas antes de editar.

  2. Configure os indicadores recomendados para registrar erros em arquivo privado e manter desativada a exibição no front-end. Proteja o log contra acesso público.

  3. Reproduza a falha, leia apenas o trecho necessário, remova dados sensíveis e reverta a configuração temporária após corrigir o problema. Confirme que o site não mostra mensagens aos visitantes.

Teste de conferência

Abra a página que apresentava erro e verifique o registro controlado. Em janela anônima, confirme que visitantes não veem caminho do servidor, consulta ou aviso técnico.

Limites e cuidado

O local e as permissões do log dependem de servidor e hospedagem. Não deixe debug público nem registre dados pessoais; procure suporte técnico se não tiver acesso seguro aos arquivos.

Continue na biblioteca

Consulte também o hub de manutencao para navegar por tarefas relacionadas.

Fonte oficial: Depurar WordPress — WordPress Developer Resources.

Continue por aqui