Objetivo: Ensinar como habilitar as mensagens de erro detalhadas do PHP no WordPress, o que é crucial para encontrar a origem de falhas.
Passo a Passo: Habilitando o Debug
-
Acesso ao Gerenciador de Arquivos:
-
Faça login no cPanel e vá em Gerenciador de Arquivos.
-
-
Localize o Arquivo:
-
Abra o diretório raiz do seu WordPress (geralmente
public_html) e encontre o arquivowp-config.php.
-
-
Edite o Arquivo:
-
Clique com o botão direito no
wp-config.phpe selecione "Edit" (Editar).
-
-
Insira o Código:
-
Localize a linha
define( 'WP_DEBUG', false );. -
Substitua-a pelo seguinte bloco de código:
PHPdefine( 'WP_DEBUG', true ); // Ativa o modo de depuração define( 'WP_DEBUG_LOG', true ); // Salva os erros no arquivo debug.log define( 'WP_DEBUG_DISPLAY', false ); // Não exibe os erros na tela (mais seguro) @ini_set( 'display_errors', 0 ); // Garante que os erros não sejam exibidos publicamente -
-
Salve e Teste:
-
Salve o arquivo. Agora, ao reproduzir o erro, o WordPress registrará os detalhes técnicos.
-
-
Localize o Log:
-
As mensagens de erro serão salvas no arquivo
wp-content/debug.log. -
Use este arquivo para identificar o plugin, tema ou linha de código que está causando o problema.
-
AVISO DE SEGURANÇA: Sempre desabilite o WP_DEBUG (voltando para false) após terminar o diagnóstico. Deixar o modo de debug ativado publicamente pode expor informações sensíveis do servidor.
