Como configurar o WordPress para exibir mensagens de erro apenas no ambiente de teste

Como configurar o WordPress para exibir mensagens de erro apenas no ambiente de teste

Olá, querido(a) cliente da GeHost! 👋

Se você está criando ou testando um site com WordPress, já deve ter notado que, por padrão, o sistema pode exibir mensagens de erro técnicas — como "Fatal error", "Notice" ou "Warning" — para os visitantes. Isso é ótimo no ambiente de desenvolvimento, mas pode assustar ou confundir seu público final.

Por isso, hoje vamos te ensinar, com carinho e clareza, como mostrar essas mensagens apenas no ambiente de teste — mantendo seu site profissional e seguro no ar.

Por que isso é importante?

Imagine que um visitante vê uma mensagem como:

Notice: Undefined index in /wp-content/themes/meu-tema/functions.php on line 42

Isso pode fazer com que ele acredite que seu site está quebrado, mesmo que esteja tudo funcionando. Por isso, é essencial deixar essas mensagens visíveis apenas para você durante o desenvolvimento.

Passo a passo: Ative o modo de depuração apenas no ambiente de teste

Para isso, vamos editar um arquivo do WordPress chamado wp-config.php. Ele está no diretório principal do seu site (normalmente dentro de public_html).

1. Entre no cPanel da sua hospedagem. Você pode acessar pelo painel.gehost.com.br.

   

2. Na tela do cPanel, encontre a seção Arquivos e clique em Gerenciador de Arquivos.

   

3. Na janela do Gerenciador de Arquivos, selecione a pasta public_html (ou a pasta do seu site, se estiver em subdomínio).

   

4. Procure pelo arquivo chamado wp-config.php. Ele geralmente está na raiz da pasta public_html.

   Se não vir o arquivo, clique em Configurações no canto superior direito e marque a opção Mostrar arquivos ocultos.

5. Clique duas vezes no arquivo wp-config.php para editá-lo.

   Se aparecer uma mensagem de aviso, confirme que deseja editar o arquivo.

6. Procure pela linha que diz:

   define('WP_DEBUG', false);

   Essa linha controla se o WordPress exibe erros ou não.

7. Substitua essa linha por:

   define('WP_DEBUG', true);

   Isso ativa o modo de depuração — agora, os erros serão exibidos.

8. Para garantir que os erros apareçam apenas no seu computador (ou no ambiente de teste), vamos adicionar uma condição inteligente. Acima da linha que você alterou, adicione esta nova linha:

   if ($_SERVER['REMOTE_ADDR'] === '127.0.0.1' || $_SERVER['REMOTE_ADDR'] === '::1') {
       define('WP_DEBUG', true);
   } else {
       define('WP_DEBUG', false);
   }

   💡 Dica: Substitua 127.0.0.1 e ::1 pelo IP da sua rede local ou pelo IP do seu computador de teste. Se não souber, use apenas 127.0.0.1 (localhost) para testes locais.

9. Salve as alterações. No Gerenciador de Arquivos, clique em Salvar ou Salvar e Fechar.

10. Pronto! Agora, quando você acessar o site do seu ambiente de teste (por exemplo, um subdomínio como teste.seudominio.com), os erros aparecerão. Mas, no site público (seudominio.com), os visitantes não verão nada.

Dica extra: Use um subdomínio para testes

Para evitar confusões, crie um subdomínio como teste.seudominio.com no cPanel (em DNS Zone ou Subdomínios) e use esse domínio apenas para testes. Dessa forma, o modo de depuração só será visível lá.

Como voltar ao normal?

Quando terminar de testar, basta voltar ao arquivo wp-config.php e trocar de volta para:

define('WP_DEBUG', false);

ou, se preferir, remova completamente a condição com $_SERVER['REMOTE_ADDR'] e deixe apenas a linha padrão.

Importante: Proteja seu site

Nunca deixe o WP_DEBUG ativado no site público. Isso pode expor informações sensíveis, como caminhos de arquivos ou credenciais de banco de dados.

Se precisar de ajuda, não hesite em entrar em contato com o suporte da GeHost — estamos aqui para te ajudar, com um sorriso no coração. 😊

Seu site, seu jeito, seu sucesso. Com carinho, Sensei da GeHost.