dev-wp wordpress snippets

debug-and-log.md

// DEV SET
// put on wp-config.php

$wpDev = function() {
    return filter_var($_COOKIE['wp-dev'] ?? null, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE) ?? false;
};


if (!defined('WP_DEBUG')) {
    // Ativar o modo de depuração
    define('WP_DEBUG', true);
}

if (!defined('WP_DEBUG_LOG')) {
    // Registrar erros em um arquivo de log em vez de exibi-los na tela
    define('WP_DEBUG_LOG', true);
}

if (!defined('WP_DEBUG_DISPLAY')) {
    // Exibir erros e avisos na tela
    define('WP_DEBUG_DISPLAY', $wpDev());
}

if (!defined('WP_DISABLE_FATAL_ERROR_HANDLER')) {
    // Desativar a tela de erro padrão do WordPress
    define('WP_DISABLE_FATAL_ERROR_HANDLER', $wpDev());
}

---

Para capturar e exibir erros no WordPress, em vez de ver a mensagem genérica de "Erro Crítico", você pode ativar o modo de depuração do WordPress. Isso permitirá que você veja mensagens de erro mais detalhadas, o que pode ajudar a identificar e corrigir problemas. Aqui estão os passos para fazer isso:

Ativar o Modo de Depuração do WordPress

1. Editar o arquivo wp-config.php:

   • Localize o arquivo wp-config.php na raiz do seu diretório de instalação do WordPress.
   • Abra o arquivo em um editor de texto.

2. Adicionar ou Modificar as Constantes de Depuração:

   • Procure por WP_DEBUG no arquivo. Se não encontrar, você pode adicionar as seguintes linhas antes da linha que diz /* That's all, stop editing! Happy blogging. */:

   // Ativar o modo de depuração
   define('WP_DEBUG', true);
   
   // Registrar erros em um arquivo de log em vez de exibi-los na tela
   define('WP_DEBUG_LOG', true);
   
   // Exibir erros e avisos na tela
   define('WP_DEBUG_DISPLAY', true);
   
   // Desativar a tela de erro padrão do WordPress
   define('WP_DISABLE_FATAL_ERROR_HANDLER', true);

3. Salvar as Alterações:

   • Salve o arquivo wp-config.php após fazer as alterações.

O que Cada Configuração Faz

• WP_DEBUG: Ativa o modo de depuração no WordPress. Quando definido como true, o WordPress começará a exibir erros e avisos.

• WP_DEBUG_LOG: Quando ativado, todos os erros e avisos serão registrados em um arquivo de log localizado em wp-content/debug.log. Isso é útil para revisar erros que ocorreram sem precisar exibi-los na tela.

• WP_DEBUG_DISPLAY: Controla se os erros e avisos são exibidos na tela. Definido como true, os erros serão exibidos diretamente no navegador.

• WP_DISABLE_FATAL_ERROR_HANDLER: Desativa o manipulador de erros fatais padrão do WordPress, que exibe a mensagem de "Erro Crítico". Isso permite que você veja mensagens de erro mais detalhadas.

Considerações de Segurança

• Ambiente de Produção: Tenha cuidado ao ativar a exibição de erros em um site de produção, pois isso pode expor informações sensíveis. É melhor usar o WP_DEBUG_LOG para registrar erros em um arquivo de log.

• Desativar Após Depuração: Após resolver os problemas, é uma boa prática desativar o modo de depuração para evitar a exposição de informações sensíveis.

Essas configurações ajudarão você a diagnosticar problemas no WordPress, fornecendo informações mais detalhadas sobre os erros que ocorrem.