Habilitando o WP_DEBUG

Este texto foi traduzido usando IA. Se você deseja ver o texto original em inglês, clique aqui.

Ao depurar problemas no seu site WordPress.com, geralmente é útil ativar o modo de depuração integrado disponível no WordPress.

Antes de ativar o WP_DEBUG

Por padrão, quaisquer erros ou avisos do servidor da Web ou do PHP do seu site são registrados automaticamente e ficam disponíveis na página de Configurações do seu site. Você pode aprender como acessar e baixar esses logs na documentação de Monitoramento do Site em Logs de acesso.

Você ainda pode ativar o WP_DEBUG, mas observe que fazer isso pode causar avisos excessivos e interromper o registro de logs padrão que o WordPress.com oferece. Também pode causar uso excessivo de disco se não for desativado e o arquivo debug.log não for excluído após o uso.

Ativar o WP_DEBUG

Para ativar o modo de depuração, siga os passos abaixo:

1. Conecte-se ao seu site WordPress usando o cliente SFTP de sua preferência.
2. Após conectar, localize o arquivo wp-config.php no diretório raiz da sua instalação do WordPress.
3. Abra o arquivo wp-config.php no seu editor de texto.
4. Encontre a seção intitulada For developers: WordPress debugging mode.
5. Atualize o código para ficar assim:

if ( ! defined( 'WP_DEBUG') ) {
	define( 'WP_DEBUG', true );
	if ( WP_DEBUG ) {
		define( 'WP_DEBUG_DISPLAY', false );
		define( 'WP_DEBUG_LOG', true );
	}
}

6. Salve as alterações feitas no arquivo wp-config.php.

Isso habilitará o modo de depuração, impedirá que qualquer registro seja exibido no front end e registrará quaisquer erros ou chamadas a error_log em um arquivo debug.log.

Você pode ler mais sobre essas configurações, bem como configurações adicionais de depuração que pode habilitar, no WordPress Advanced Administration Handbook

Recuperar logs

Agora que você habilitou o modo de depuração, pode recuperar os logs para ajudar a diagnosticar problemas:

1. Reconecte-se ao seu site WordPress usando SFTP.
2. Navegue até o diretório wp-content e localize o arquivo debug.log.
3. Baixe ou visualize o arquivo debug.log. Você pode baixar o arquivo debug.log para o seu computador ou visualizá-lo diretamente usando um editor de texto.

Desabilitar WP_DEBUG

Para evitar problemas de desempenho e manter informações sensíveis seguras, é importante desabilitar o modo de depuração no seu ambiente de produção após concluir a depuração.

Depois de concluir a depuração, desabilite o WP_DEBUG seguindo estas etapas:

1. Reconecte-se ao seu site WordPress novamente com SFTP.
2. Localize o arquivo wp-config.php no diretório raiz da sua instalação do WordPress.
3. Abra o arquivo wp-config.php no seu editor de texto.
4. Encontre a seção intitulada For developers: WordPress debugging mode.
5. Atualize o código para ficar assim:

if ( ! defined( 'WP_DEBUG') ) {
	define( 'WP_DEBUG', false );
}

6. Salve as alterações feitas no arquivo wp-config.php.