Activer WP_DEBUG

Ce texte a été traduit à l’aide de l’IA. Si vous souhaitez consulter le texte original en anglais, cliquez ici.

Lors du débogage de problèmes sur votre site WordPress.com, il est souvent utile d’activer le mode de débogage intégré à WordPress.

Avant d’activer WP_DEBUG

Par défaut, toutes les erreurs ou avertissements du serveur Web ou de PHP pour votre site sont automatiquement journalisés et disponibles depuis la page Réglages de votre site. Vous pouvez apprendre comment accéder à ces journaux et les télécharger dans la documentation sur la surveillance du site sous Journaux d’accès.

Vous pouvez toujours activer WP_DEBUG, mais veuillez noter que cela peut provoquer des avertissements excessifs et perturber la journalisation par défaut fournie par WordPress.com. Cela peut également entraîner une utilisation excessive de l’espace disque si le mode n’est pas désactivé et le fichier debug.log supprimé après utilisation.

Activer WP_DEBUG

Pour activer le mode de débogage, suivez les étapes suivantes :

1. Connectez-vous à votre site WordPress en utilisant votre client SFTP préféré.
2. Une fois connecté, localisez le fichier wp-config.php dans le répertoire racine de votre installation WordPress.
3. Ouvrez le fichier wp-config.php dans votre éditeur de texte.
4. Trouvez la section intitulée For developers: WordPress debugging mode.
5. Modifiez le code pour qu’il ressemble à ceci :

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

6. Enregistrez les modifications apportées au fichier wp-config.php.

Cela activera le mode débogage, empêchera l’affichage des journaux côté public, et enregistrera toutes les erreurs ou appels à error_log dans un fichier debug.log.

Vous pouvez en savoir plus sur ces réglages, ainsi que sur d’autres paramètres de débogage que vous pouvez activer, dans le WordPress Advanced Administration Handbook.

Récupérer les journaux

Maintenant que vous avez activé le mode débogage, vous pouvez récupérer les journaux pour vous aider à diagnostiquer les problèmes :

1. Reconnectez-vous à votre site WordPress en utilisant SFTP.
2. Accédez au répertoire wp-content et localisez le fichier debug.log.
3. Téléchargez ou consultez le fichier debug.log. Vous pouvez télécharger le fichier debug.log sur votre ordinateur ou le consulter directement à l’aide d’un éditeur de texte.

Désactiver WP_DEBUG

Pour éviter les problèmes de performance et protéger les informations sensibles, il est important de désactiver le mode débogage dans votre environnement de production une fois le débogage terminé.

Une fois le débogage terminé, désactivez WP_DEBUG en suivant les étapes suivantes :

1. Reconnectez-vous à votre site WordPress avec SFTP.
2. Localisez le fichier wp-config.php dans le répertoire racine de votre installation WordPress.
3. Ouvrez le fichier wp-config.php dans votre éditeur de texte.
4. Trouvez la section intitulée For developers: WordPress debugging mode.
5. Mettez à jour le code pour qu’il ressemble à ceci :

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

6. Enregistrez les modifications apportées au fichier wp-config.php.