Como ativar debug mode no WordPress seguramente Print

Como ativar o Debug Mode no WordPress seguramente — Guia do Sensei da GeHost

Olá, amigo(a) do WordPress! Se você está aqui, provavelmente está tentando resolver um problema, verificar erros ou entender melhor como seu site está funcionando. E o melhor caminho para isso é ativar o Debug Mode — uma ferramenta poderosa, mas que precisa ser usada com cuidado. Não se preocupe: vou te guiar passo a passo, com segurança e carinho, como se fosse um amigo que te ensina a montar um quebra-cabeça.

Ativar o Debug Mode permite que o WordPress mostre erros, avisos e mensagens de depuração diretamente no seu site. Isso é super útil para desenvolvedores, mas não deve ficar ativo em produção — pois pode expor informações sensíveis para visitantes.

Dica do Sensei: Sempre ative o Debug Mode apenas em ambientes de teste ou em sites que você controla. Nunca deixe ele ativo em um site público!

Passo 1: Acesse o Gerenciador de Arquivos do cPanel

Para começar, você precisa acessar o painel de controle da sua hospedagem (cPanel). Faça login com seu usuário e senha — eles são os mesmos que usamos para o site e e-mail.

Depois de logado, procure pela ferramenta chamada Gerenciador de Arquivos. Ela está no grupo "Arquivos".

Passo 2: Navegue até o diretório do seu site

Na tela do Gerenciador de Arquivos, clique em public_html (ou o nome da pasta onde seu WordPress está instalado).

Se você não tiver certeza, procure por uma pasta que contenha arquivos como wp-config.php, index.php ou wp-content. Esses são indícios de que está no diretório certo.

Passo 3: Edite o arquivo wp-config.php

Procure pelo arquivo chamado wp-config.php. Ele está no diretório principal do WordPress (geralmente dentro de public_html).

Clique com o botão direito sobre ele e selecione Editar (ou "Editar com o editor de texto").

⚠️ Atenção: Não altere nada além do que for pedido. Um erro de digitação pode deixar seu site inacessível.

Passo 4: Adicione as linhas de debug

Procure pela linha que diz:

define('WP_DEBUG', false);

Substitua false por true:

define('WP_DEBUG', true);

Agora, adicione as linhas abaixo, uma por vez, logo abaixo:

• define('WP_DEBUG_LOG', true);
• define('WP_DEBUG_DISPLAY', false);

Seu código final deve ficar assim:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Explicando:

• WP_DEBUG = ativa o modo de depuração.
• WP_DEBUG_LOG = salva os erros em um arquivo (não mostra na tela).
• WP_DEBUG_DISPLAY = evita que erros apareçam no navegador (segurança).

Passo 5: Salve as alterações

Após editar, clique em Salvar ou Salvar Arquivo (geralmente no canto superior direito do editor).

Se tudo estiver certo, o sistema vai confirmar que o arquivo foi salvo com sucesso.

Passo 6: Verifique os erros (opcional)

Depois de ativar o debug, navegue pelo seu site, faça algumas ações (como acessar uma página, enviar um formulário, etc.) e veja se surgem mensagens.

Os erros serão salvos no arquivo wp-content/debug.log. Para ver esse arquivo:

1. Volte ao Gerenciador de Arquivos.
2. Abra a pasta wp-content.
3. Localize o arquivo debug.log.
4. Clique em Editar para visualizar os erros.

Esse arquivo é seu “diário de bordo” — ele vai te ajudar a entender onde está o problema.

Passo 7: Desative o Debug Mode (quando terminar)

Assim que resolver o problema, volte ao arquivo wp-config.php e faça o seguinte:

• Altere WP_DEBUG de true para false.
• Salve o arquivo.

Isso garante que seu site volte a funcionar com segurança, sem expor dados sensíveis.

Lei do Sensei: Debug é como uma lanterna — útil para encontrar um problema no escuro, mas perigoso se deixada acesa em dia claro. Use com sabedoria!

Dica extra: Use um plugin de debug (para iniciantes)

Se você acha que editar arquivos pode ser arriscado, considere usar o plugin Query Monitor (disponível na loja do WordPress). Ele mostra erros, consultas ao banco, tempos de carregamento e muito mais — tudo dentro do painel do WordPress, sem precisar tocar no código.

É uma ótima alternativa para quem está começando. Mas, para soluções mais profundas, o debug no wp-config.php ainda é o mais poderoso.

Resumo rápido

• Ative apenas em ambiente seguro.
• Use WP_DEBUG_LOG e WP_DEBUG_DISPLAY = false para segurança.
• Salve erros no arquivo debug.log.
• Desative o debug assim que terminar.
• Nunca deixe o debug ativo em produção!

Se precisar de ajuda, é só chamar o nosso suporte — estamos aqui para te ajudar, como um bom Sensei. 🙏