HÉBERGEMENT WEB

HomeBASE DE CONNAISSANCESHÉBERGEMENT WEB

WordPress : Comment activer le mode debug ?

48 views /  0 like /  

WordPress propose un mode débogage efficace pour identifier et résoudre les problèmes sur votre site. En l’activant, vous pouvez détecter les erreurs, avertissements, et notifications PHP, facilitant ainsi le dépannage et l’optimisation de votre plateforme web. Ce mode est essentiel pour maintenir un site WordPress performant et sécurisé.

Le débogage permet de repérer non seulement les dysfonctionnements apparents, mais aussi les problèmes latents qui pourraient affecter votre site à long terme. Grâce aux outils intégrés, vous pouvez rapidement identifier la source des erreurs, qu’elles proviennent du cœur de WordPress, de thèmes, ou de plugins.

Cet article vous guidera pour activer le mode débogage et créer un fichier de log, le tout sans perturber votre site en ligne. Nous aborderons également des techniques pour personnaliser le processus selon vos besoins. Bien que puissant, le débogage doit être utilisé avec précaution, surtout sur les sites en production.

Que vous soyez débutant ou expert, ce guide vous aidera à maîtriser le débogage de votre site WordPress. Explorons maintenant les étapes pour activer et configurer efficacement ce mode essentiel.

Qu’est-ce que le débogage ?

Le débogage dans WordPress consiste à identifier et corriger les erreurs sur un site ou un plugin en analysant le code et les journaux d’erreurs. Il couvre des problèmes tels que les liens brisés, les plugins défaillants, et les erreurs PHP. Une fois identifiés, les problèmes peuvent être résolus en modifiant le code, en désactivant des plugins ou en appliquant des mises à jour. Il est essentiel de tester soigneusement le site après les corrections pour s’assurer qu’il reste stable.

Remarque : Sauvegardez votre site avant d’activer le débogage. Vous pourrez ainsi le restaurer facilement en cas de problème. Consultez notre guide pour les sauvegardes WordPress.

Comment activer le débogage de WordPress?

Connectez-vous à votre cPanel.
Ouvrez le gestionnaire de fichiers.


Naviguez vers le répertoire racine de votre installation WordPress .


Trouvez et éditez le fichier wp-config.php.

Activer WP_DEBUG

Ouvrez le fichier wp-config.php

Recherchez la ligne : define('WP_DEBUG', false);

Si elle n’existe pas, ajoutez-la juste avant /* That's all, stop editing! Happy publishing. */

Modifiez-la comme suit :

define(‘WP_DEBUG’, true);

Cette modification active le mode de débogage général de WordPress.

Activer WP_DEBUG_LOG

Dans le même fichier wp-config.php
Ajoutez la ligne suivante juste après celle de WP_DEBUG :

define(‘WP_DEBUG_LOG’, true);

Cela enregistrera tous les messages d’erreur et d’avertissement dans un fichier debug.log dans le répertoire wp-content.

Activer SCRIPT_DEBUG

Toujours dans wp-config.php
Ajoutez cette ligne :

define(‘SCRIPT_DEBUG’, true);

Cela force WordPress à utiliser les versions non minifiées des fichiers CSS et JavaScript du cœur, ce qui peut aider à déboguer les problèmes liés aux scripts.

Configurer un débogage PHP personnalisé

Créez un plugin personnalisé ou utilisez un plugin de snippets de code existant.

 Ajoutez la fonction suivante dans votre plugin ou snippet :

php
function write_log($data) {
if (true === WP_DEBUG) {
if (is_array($data) || is_object($data)) {
error_log(print_r($data, true));
} else {
error_log($data);
}
}
}}

 Assurez-vous que WP_DEBUG est activé dans votre fichier wp-config.php :

php
define('WP_DEBUG', true);;

 Pour utiliser cette fonction de débogage, vous pouvez maintenant l’appeler dans votre code comme suit :

php
write_log(‘DEBUG TEXT’);
write_log($variable);

Cette approche offre plusieurs avantages :

  1. Elle permet un formatage correct des tableaux et des objets, les rendant plus lisibles dans les logs.
  2. Elle dépend de WP_DEBUG, ce qui signifie que le logging ne se produira que lorsque le mode de débogage est activé.
  3. Elle offre une méthode cohérente et facile à utiliser pour le logging à travers votre site.

Remarques importantes :

  • N’ajoutez pas ce code directement dans le fichier functions.php de votre thème. L’utilisation d’un plugin ou d’un gestionnaire de snippets est préférable pour des raisons de maintenance, de sécurité, de performance et d’organisation du code.
  • Assurez-vous de désactiver ou de supprimer ce code en production, ou au moins de désactiver WP_DEBUG.
  • Vérifiez régulièrement vos fichiers de log pour éviter qu’ils ne deviennent trop volumineux.

Cette méthode vous permet de logger des informations de débogage de manière plus flexible et lisible, tout en maintenant de bonnes pratiques de développement WordPress.

Conseils supplémentaires

  • Il est recommandé de désactiver l’affichage des erreurs sur le site en production. Pour cela, ajoutez :

define(‘WP_DEBUG_DISPLAY’, false);

  • Après le débogage, n’oubliez pas de désactiver ces options en les remettant à false ou en les supprimant, surtout sur un site en production.
  • Vérifiez régulièrement les fichiers de log pour qu’ils ne deviennent pas trop volumineux.

 

 

Articles Liés