Utiliser le mode débogage de WordPress

Le mode debug de WordPress est un outil très utile pour les webmasters débutants et avancés qui cherchent à résoudre des problèmes sur leur site WordPress.

Qu’est-ce que le mode debug de WordPress ?

Le mode debug de WordPress est un outil de débogage intégré qui permet aux développeurs et aux webmasters de collecter des informations détaillées sur les erreurs qui se produisent sur un site WordPress. Lorsqu’il est activé, le mode debug affiche des informations sur les erreurs PHP, les avertissements, les notifications et les erreurs de base de données directement sur la page du site, ou les écrit dans un fichier de journal.

Le mode debug de WordPress peut être très utile pour résoudre les problèmes techniques sur un site WordPress, tels que les erreurs d’affichage, les problèmes de thème, les erreurs de plugin, les erreurs de connexion à la base de données, etc. En utilisant les informations collectées par le mode debug, les développeurs peuvent localiser les erreurs plus facilement et travailler à les corriger plus rapidement.

Il est recommandé de désactiver le mode debug une fois que vous avez terminé de déboguer votre site.

Quand utiliser le mode debug de WordPress ?

Le mode debug de WordPress doit être utilisé lorsque vous rencontrez des problèmes sur votre site Web, tels que des erreurs d’affichage, des erreurs de connexion à la base de données, des erreurs de plugin ou de thème, des erreurs de mise à jour WordPress, etc.

Il est important de noter que le mode debug doit être activé uniquement lorsque vous rencontrez des problèmes, car il peut affecter les performances de votre site en ralentissant sa vitesse de chargement.

Comment activer le mode debug de WordPress ?

Pour activer le mode debug de WordPress, vous devez ajouter une ligne de code à votre fichier wp-config.php. Vous pouvez accéder à ce fichier en vous connectant à votre site via un client FTP, en naviguant dans le répertoire racine de votre site WordPress, puis en ouvrant le fichier wp-config.php à l’aide d’un éditeur de texte. Une fois que vous avez ouvert le fichier, ajoutez la ligne de code suivante juste avant la ligne qui contient « That’s all, stop editing! Happy blogging. » :

define( 'WP_DEBUG', true );

Cette ligne de code active le mode debug de WordPress. Vous pouvez également ajouter des lignes de code supplémentaires pour obtenir des informations plus détaillées sur les erreurs qui se produisent sur votre site, par exemple :

define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Ces lignes de code écrivent des informations de débogage dans un fichier de journal et empêchent l’affichage des erreurs à l’utilisateur final.

Une fois que vous avez ajouté ces lignes de code, enregistrez le fichier wp-config.php et téléchargez-le sur votre serveur. Assurez-vous que le fichier a été correctement enregistré sur votre serveur.

Utiliser FTP pour activer le mode debug de WordPress

  1. Téléchargez et installez un client FTP sur votre ordinateur. Il existe plusieurs clients FTP gratuits disponibles, tels que FileZilla, Cyberduck, ou WinSCP. Une fois que vous avez installé votre client FTP, ouvrez-le.
  2. Connectez-vous à votre serveur distant en utilisant les informations d’accès FTP que vous avez reçues de One2Net. Vous devrez entrer l’adresse du serveur, le nom d’utilisateur et le mot de passe. Si vous utilisez FileZilla, vous pouvez également entrer le numéro de port FTP.
  3. Une fois que vous êtes connecté, naviguez jusqu’au répertoire racine de votre site WordPress. Ce répertoire est habituellement « www » ou le répertoire que vous avez choisi pour une installation personnalisée de WordPress.
  4. Trouvez le fichier wp-config.php dans le répertoire racine de votre site WordPress. Cliquez dessus pour le sélectionner.
  5. Cliquez avec le bouton droit de la souris sur le fichier wp-config.php et sélectionnez « éditer » ou « view/edit » selon votre client FTP. Cela ouvrira le fichier dans un éditeur de texte.
  6. Ajouter les lignes de directives selon le mode d’affichage ou enregistrement souhaité
  7. Enregistrez les modifications que vous avez apportées au fichier wp-config.php.
  8. Déconnectez-vous du serveur en utilisant les options de déconnexion fournies par votre client FTP.
  9. Une fois que vous avez activé le mode debug de WordPress en ajoutant la ligne de code appropriée dans le fichier wp-config.php, vous pouvez accéder à votre site pour voir les erreurs qui se produisent. Les erreurs apparaîtront généralement en haut ou en bas de la page.

N’oubliez pas que vous devez désactiver le mode debug de WordPress une fois que vous avez terminé de déboguer votre site en supprimant la ligne de code que vous avez ajoutée dans le fichier wp-config.php.

Comment utiliser le mode debug de WordPress ?

Une fois que vous avez activé le mode debug de WordPress, vous pouvez accéder à votre site pour voir les erreurs qui se produisent. Les erreurs apparaissent généralement en haut ou en bas de la page. Vous pouvez également consulter le fichier de journal pour voir les erreurs qui ont été enregistrées. Le fichier de journal se trouve habituellement dans le répertoire /wp-content/.

Lorsque vous avez terminé de déboguer votre site, vous devez désactiver le mode debug de WordPress en supprimant la ligne de code que vous avez ajoutée dans le fichier wp-config.php. Vous pouvez également supprimer les fichiers de journal pour libérer de l’espace sur votre serveur.

Fichier d’erreur PHP

En complément du mode débug de WordPress, pensez également à consulter le fichier d’erreur PHP qui se trouve à la racine de votre espace d’hébergement et auquel vous avez accès en FTP. Selon la nature des erreurs sur votre site WordPress, ce fichier peut contenir des informations utiles.

error_php.log

Documentation officielle de WordPress