Resumo de IA
Ao solucionar problemas com plugins, temas ou código personalizado do WordPress, pode ser necessário ativar a depuração do WordPress. Esse recurso registra quaisquer erros detectados em seu site, ajudando você a identificar a origem dos problemas ou a obter mais detalhes sobre possíveis falhas.
Este guia mostrará como ativar a depuração com segurança em seu site WordPress.
Ativando a Depuração no WordPress
Para ativar a depuração em seu site, siga as etapas abaixo.
1) Localizando o arquivo wp-config.php
Por padrão, a depuração do WordPress estará desativada. Para ativá-la, você precisará acessar os arquivos do seu site por meio de um FTP (File Transfer Protocol) ou do cPanel do seu servidor.
Para saber mais sobre FTP, consulte este artigo da WPBeginner. Alternativamente, nossos amigos da WPBeginner também têm um artigo sobre informações do cPanel, que você pode ver aqui.
Alternativamente, você também pode simplesmente instalar um plugin como o WP File Manager para acessar facilmente os arquivos do seu servidor pela área administrativa do WordPress. Para saber mais sobre esse plugin, consulte o plugin deles no WordPress.org.
2) Editando o arquivo wp-config.php
Assim que os arquivos do seu site estiverem abertos, você precisará abrir o wp-config.php para edição.
Este arquivo estará localizado na pasta raiz do seu servidor. Para saber mais sobre a localização e instruções de diretório, consulte este artigo.
Localize o arquivo wp-config.php no diretório raiz do seu site. Este arquivo contém as configurações de configuração principais do seu site.
Encontre esta linha perto do final do arquivo:
('WP_DEBUG', false);
3) Ativando a depuração
Substitua-a por este trecho de código com a configuração de depuração:
// Enable WP_DEBUG mode
define( 'WP_DEBUG', true );
// Enable Debug logging to the /wp-content/debug.log file
define( 'WP_DEBUG_LOG', true );
// Disable display of errors and warnings
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
// Use dev versions of core JS and CSS files (only needed if you are modifying these core files)
define( 'SCRIPT_DEBUG', true );
Isso ativará a depuração e, importante, impedirá que quaisquer dados registrados sejam exibidos em seu site. Em vez disso, um log de depuração será salvo nos arquivos do seu site.
4) Replicando o problema
Após salvar essas alterações no wp-config.php, você precisará retornar ao seu site e replicar o problema que viu anteriormente. Isso garantirá que ele seja registrado no novo log de erros.
5) Visualizando o log de depuração
Em seguida, você pode retornar aos arquivos do seu site e abrir https://seusitename.com/wp-content/debug.log
O conteúdo de um log de erros pode variar bastante dependendo da causa e do número de problemas, mas agora você deve ser capaz de ver detalhes extras, como o caminho de um arquivo para a origem de um erro de código, para ajudá-lo a rastrear melhor o problema.
Para obter informações mais detalhadas sobre a depuração do WordPress, consulte a Documentação Oficial de Depuração do WordPress.