{"id":16411,"date":"2019-06-21T11:07:24","date_gmt":"2019-06-21T14:07:24","guid":{"rendered":"https:\/\/blog.hostinger.io\/br-tutoriais\/?p=16411"},"modified":"2025-12-18T11:51:59","modified_gmt":"2025-12-18T14:51:59","slug":"debug-wordpress","status":"publish","type":"post","link":"\/br\/tutoriais\/debug-wordpress\/","title":{"rendered":"Debug WordPress: o que \u00e9, como ativar e dicas pr\u00e1ticas"},"content":{"rendered":"

O modo debug (depuração) do WordPress é um recurso que permite registrar mensagens de erro para que você possa solucionar os problemas do seu site de maneira mais precisa. Ele é fundamental para manter seu site funcionando, especialmente depois de adicionar códigos personalizados que podem causar problemas.<\/p>

Este tutorial explicará como funciona o modo debug do WordPress e todas as maneiras de ativá-lo. Cada um dos métodos listados se adequará a um tipo de tarefa de solução de problemas — portanto, escolha com base em suas necessidades. Vamos lá?<\/p>

\n\n\n\n\n\n\n<\/p>

<\/p>

\n\n\n

\n \n \n <\/svg>\n

\n O que é debug no WordPress?\n <\/p>\n <\/div>\n

O debug do WordPress é um recurso que permite aos desenvolvedores listar as mensagens de erro geradas pela plataforma para solucionar problemas. É possível ativá-lo com algumas variáveis globais do PHP, como WP_DEBUG <\/strong>e SCRIPT_DEBUG<\/strong>. Como alternativa, você pode depurar o WordPress realizando a exibição de dados importantes, como a execução de scripts, usando um plugin.<\/p><\/div>\n\n\n\n<\/p>

Como ativar o debug do WordPress com programação<\/strong><\/h2>

Nesta seção, explicaremos como ativar o modo de debug do WordPress usando quatro variáveis PHP, que diferem com base nas suas necessidades.<\/p>

1. Ative o WP_DEBUG<\/strong><\/h3>

Ativar o WP_DEBUG <\/strong>é a maneira mais básica de iniciar o debug no WordPress. Ele pode verificar se há problemas de código PHP em diferentes componentes do site, incluindo temas e plugins.<\/p>

Para usar a variável global WP_DEBUG, basta alterar seu valor no arquivo wp-config.php<\/strong><\/a> de FALSE <\/strong>para TRUE<\/strong>. Antes de fazer isso, verifique se é possível acessar a pasta raiz do WordPress usando um aplicativo de protocolo de transferência de arquivos (FTP), como o FileZilla<\/strong><\/a>,<\/strong> ou o gerenciador de arquivos do seu provedor de hospedagem.<\/p>

Se você usar um cliente FTP, será necessário fazer o download do arquivo PHP, editá-lo no computador e enviá-lo novamente para o site.<\/p>

Para simplificar o processo, usaremos o Gerenciador de Arquivos da Hostinger<\/strong><\/a>, que permite editar o wp-config.php <\/strong>diretamente no seu navegador. Siga os passos abaixo:<\/p>

    \n
  1. Faça login no hPanel. <\/strong>Navegue até Sites <\/strong>→ Painel <\/strong>→ Gerenciador de Arquivos<\/strong>. <\/li>\n\n\n\n
  2. Vá para a pasta raiz public_html <\/strong>do WordPress.<\/li>\n\n\n\n
  3. Abra o arquivo wp-config.php <\/strong>clicando duas vezes nele. <\/li>\n\n\n\n
  4. Encontre a seguinte linha. Se você não conseguir localizar essa entrada, adicione-a manualmente após a linha $table_prefix = ‘wp_’;<\/strong>:<\/li>\n<\/ol>
    define( 'WP_DEBUG', false ); <\/pre>
      \n
    1. Altere o valor de FALSE para TRUE<\/strong>.<\/li>\n<\/ol>
      \n
      \"editando<\/figure>\n<\/div>
        \n
      1. Clique no ícone <\/strong>de disquete <\/strong>no canto superior direito do editor para salvar as alterações. <\/li>\n<\/ol>
        É isso! Se você encontrar problemas com o PHP, o WordPress exibirá a mensagem de erro no front-end.<\/p>
        \n
        \"exemplo<\/figure>\n<\/div>
        O WordPress fornece algumas variáveis PHP adicionais para modificar o modo de depuração. Por exemplo, WP_DEBUG_DISPLAY <\/strong>oculta as mensagens de erro no front-end quando definida como FALSE, <\/strong>para não atrapalhar a experiência do usuário.<\/p>
        Os desenvolvedores geralmente a utilizam junto com a WP_DEBUG_LOG<\/strong>, que lista os problemas do PHP no arquivo debug.log <\/strong>dentro do diretório wp-content<\/strong>. Como o WP_DEBUG, você adiciona essas variáveis ao wp-config.php <\/strong>acima da linha “That’s all, stop editing!<\/strong>” (Isso é tudo, pare de editar!<\/strong>). Sua configuração deve ficar parecida com o código a seguir:<\/p>
        if ( ! defined( 'WP_DEBUG' ) ) {\n\n   define( 'WP_DEBUG', true );\n\n   define('WP_DEBUG_DISPLAY', false);\n\n   define('WP_DEBUG_LOG', true);\n\n}<\/pre>
        Lembre-se de que o WordPress registrará apenas as mensagens que ocorrerem depois que você ativar a variável WP_DEBUG_LOG<\/strong>. Se você quiser registrar problemas anteriores, será necessário manualmente.<\/p>
        \n
        \"mensagens<\/figure>\n<\/div>
        \n\n
        \n            \n                \n                    \n                <\/svg>\n                Important\n            <\/span>\n            
        \n                Importante! <\/strong>Se você quiser desativar o modo de depuração do WordPress, lembre-se de definir WP_DEBUG_DISPLAY <\/strong>e WP_DEBUG_LOG <\/strong>como FALSE <\/strong>para evitar que esses recursos sejam executados indefinidamente e desperdicem recursos.\n            <\/p><\/div>\n\n\n\n<\/p>
        2. Ative o SCRIPT_DEBUG<\/strong><\/h3>
        Por padrão, o WordPress executa arquivos principais de JavaScript (JS) e CSS minificados que ocultam recursos não essenciais, como mensagens de erro. Embora esse comportamento ajude a melhorar a velocidade do seu site, ele pode tornar a solução de problemas mais complicada, pois você não consegue ver as informações detalhadas dos erros.<\/p>
        Para depurar os arquivos JS e CSS, você pode ativar as versões de desenvolvimento deles usando a variável SCRIPT_DEBUG. Ela é especialmente útil caso você tenha modificado o visual do seu site usando essas linguagens de programação.<\/p>
        As etapas para ativar o SCRIPT_DEBUG são semelhantes às do WP_DEBUG. Veja como fazê-lo usando o Gerenciador de Arquivos da Hostinger:<\/p>
          \n
        1. Abra a pasta raiz public_html <\/strong>do WordPress.<\/li>\n\n\n\n
        2. Clique duas vezes no arquivo wp-config.php <\/strong>para abri-lo. <\/li>\n\n\n\n
        3. Localize a linha abaixo e altere seu valor de FALSE <\/strong>para TRUE<\/strong>. Se não encontrá-la, adicione-a antes da linha “That’s all stop editing<\/strong>“.<\/li>\n<\/ol>
          define( 'SCRIPT_DEBUG', true );<\/pre>
            \n
          1. Clique no ícone de disquete <\/strong>no canto superior direito para salvar as alterações. <\/li>\n<\/ol>
            Agora, se seu site encontrar problemas relacionados ao CSS ou ao JavaScript, ele deverá exibir as mensagens de erro completas. Após solucionar os problemas que você quer corrigir, lembre-se de desativar essa variável e reativar os arquivos minificados para evitar problemas de desempenho.<\/p>
            3. Ative o log file do PHP<\/strong><\/h3>
            O PHP possui a função error_log() <\/strong>integrada, que permite registrar problemas relacionados à linguagem. Esse recurso é executado no nível do servidor, o que significa que ele pode depurar todos os aplicativos PHP em seu ambiente de hospedagem, inclusive o WordPress e seu banco de dados.<\/p>
            Você pode ativar o debug log<\/em> do PHP usando o arquivo php.ini<\/strong><\/a>. No entanto, vários provedores de hospedagem desativam esse recurso devido a questões de design e segurança.<\/p>
            Se você usa os planos de hospedagem WordPress<\/strong><\/a> da Hostinger, é possível ativar esse recurso por meio do hPanel. Veja como:<\/p>
              \n
            1. Faça login no hPanel <\/strong>e vá para Sites <\/strong>→ Painel <\/strong>→ Barra lateral <\/strong>→ Avançado <\/strong>→ Configuração de PHP<\/strong>.<\/li>\n\n\n\n
            2. Selecione a guia Opções de PHP<\/strong>. <\/li>\n\n\n\n
            3. Ative a caixa logErrors <\/strong>para ativar o registro. Se você quiser exibir a mensagem de erro no front end, ative a opção displayErrors<\/strong>. Recomendamos deixá-la desmarcada. <\/li>\n\n\n\n
            4. Role a tela para baixo e pressione Salvar<\/strong>.<\/li>\n<\/ol>
              \n
              \"\"<\/a><\/figure>\n<\/div>
              Você pode acessar o arquivo de registro abrindo o diretório .log <\/strong>na pasta raiz do seu servidor. Veja como fazer isso no Gerenciador de Arquivos da Hostinger:<\/p>
                \n
              1. No painel do hPanel<\/strong>, navegue até a barra lateral <\/strong>→ Arquivos <\/strong>→ Gerenciador de arquivos<\/strong>.<\/li>\n\n\n\n
              2. Clique no botão Acessar todos os arquivos de hospedagem<\/strong>.<\/li>\n\n\n\n
              3. Abra a pasta .log<\/strong>. Se você não encontrar esse diretório, ele pode estar oculto. Para exibi-lo, vá até a barra lateral <\/strong>→ Configurações <\/strong>e desmarque a opção Ocultar dotfilesbox<\/strong>.<\/li>\n\n\n\n
              4. Clique duas vezes no arquivo error_log_domain_tld <\/strong>para ver todos os erros de PHP em seu site, incluindo seus registros de data e hora e tipos. <\/li>\n<\/ol>
                4. Ative o relatório de erros do WPDB<\/strong><\/h3>
                Para depurar seu banco de dados do WordPress, ative a variável show_errorsvariable <\/strong>da classe wpdb<\/strong>. Essa configuração exibirá erros de SQL em seu site, o que ajuda a solucionar problemas de conexão com o banco de dados e erros de sintaxe.<\/p>
                Veja como ativar o relatório de erros do WPDB <\/strong>por meio do Gerenciador de Arquivos da Hostinger:<\/p>
                  \n
                1. Abra a pasta public_html <\/strong>do seu site WordPress e vá até a pasta wp-includes<\/strong>.<\/li>\n\n\n\n
                2. Clique duas vezes no arquivo class-wpdb.php <\/strong>para abri-lo. <\/li>\n\n\n\n
                3. Localize a linha class wpdb<\/strong>.<\/li>\n\n\n\n
                4. Dentro de seus colchetes, localize a variável $show_errors <\/strong>e altere seu valor para TRUE, <\/strong>da seguinte forma:<\/li>\n<\/ol>
                  public $show_errors = true; <\/pre>
                    \n
                  1. Clique no ícone do disquete <\/strong>para salvar as alterações. <\/li>\n<\/ol>
                    Como ativar o debug WordPress usando um plugin<\/strong><\/h2>
                    Se você não se sentir à vontade para mexer com programação diretamente, é possível ativar o modo de debug do WordPress usando um plugin. Por exemplo, o WP Debugging<\/strong><\/a> permite que você altere o valor da variável WP_DEBUG diretamente do painel de administração.<\/p>
                    Depois de baixar e instalar o plugin<\/strong><\/a> por meio do painel do WordPress, siga estas etapas para ativar o modo de depuração:<\/p>
                      \n
                    1. Vá para a barra lateral <\/strong>→ Tools <\/strong>→ WP Debugging<\/strong>.<\/li>\n\n\n\n
                    2. Marque a caixa Set WP_DEBUG to true<\/strong>. Opcionalmente, você pode definir se deseja que o WordPress mostre os problemas no front-end e ignore os erros fatais. <\/li>\n<\/ol>
                      \n
                      \"ativando<\/figure>\n<\/div>
                        \n
                      1. Clique em Salvar alterações<\/strong>.<\/li>\n<\/ol>
                        Para uma análise mais completa do que o recurso de debug padrão do WordPress, recomendamos o Query Monitor<\/strong><\/a>. Ele exibe dados para solucionar problemas de consultas a bancos de dados, chamadas PHP e execuções de scripts.<\/p>
                        \n
                        \"opções<\/figure>\n<\/div>
                        Depois de instalar o plugin, um menu será exibido em sua barra de administração. Ao clicar nele, você tem acesso a uma janela que detalha várias categorias de dados, como:<\/p>