Résumé IA
Lorsque vous dépannez des problèmes avec des plugins, des thèmes ou du code personnalisé WordPress, vous devrez peut-être activer le débogage WordPress. Cette fonctionnalité enregistre toutes les erreurs détectées sur votre site, vous aidant à identifier la source des problèmes ou à recueillir plus de détails sur les problèmes potentiels.
Ce guide vous montrera comment activer le débogage en toute sécurité sur votre site WordPress.
Activer le débogage dans WordPress
Pour activer le débogage sur votre site, veuillez suivre les étapes ci-dessous.
1) Localisation du fichier wp-config.php
Par défaut, le débogage WordPress sera désactivé. Pour l'activer, vous devrez accéder aux fichiers de votre site via FTP (File Transfer Protocol) ou le cPanel de votre serveur.
Pour en savoir plus sur le FTP, veuillez consulter cet article de WPBeginner. Alternativement, nos amis de WPBeginner ont également un article sur les informations cPanel, que vous pouvez consulter ici.
Alternativement, vous pouvez également simplement installer un plugin comme WP File Manager pour accéder facilement aux fichiers de votre serveur via la zone d'administration de WordPress. Pour en savoir plus sur ce plugin veuillez consulter leur plugin sur WordPress.org.
2) Modification du fichier wp-config.php
Une fois les fichiers de votre site ouverts, vous devrez ouvrir wp-config.php pour modification.
Ce fichier sera situé dans le dossier racine de votre serveur. Pour en savoir plus sur l'emplacement et les instructions de répertoire, veuillez consulter cet article.
Localisez le fichier wp-config.php dans le répertoire racine de votre site. Ce fichier contient les paramètres de configuration de base de votre site.
Trouvez cette ligne près du bas du fichier :
('WP_DEBUG', false);
3) Activation du débogage
Remplacez-la par cet extrait de code avec la configuration de débogage :
// 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 );
Cela activera le débogage et, surtout, empêchera l'affichage des données enregistrées sur votre site. Au lieu de cela, un journal de débogage sera enregistré dans les fichiers de votre site.
4) Réplication du problème
Après avoir enregistré ces modifications dans wp-config.php, vous devrez revenir sur votre site et reproduire le problème que vous avez vu précédemment. Cela garantira qu'il est enregistré dans le nouveau journal d'erreurs.
5) Consultation du journal de débogage
Ensuite, vous pouvez revenir aux fichiers de votre site et ouvrir https://votrenomsite.com/wp-content/debug.log
Le contenu d'un journal d'erreurs peut varier considérablement en fonction de la cause et du nombre de problèmes, mais vous devriez maintenant être en mesure de voir des détails supplémentaires, tels qu'un chemin de fichier vers la source d'une erreur de code, pour vous aider à mieux identifier le problème.
Pour plus d'informations sur le débogage de WordPress, consultez la documentation officielle sur le débogage de WordPress.