Activer le mode debug WordPress : Guide pratique

Votre site WordPress affiche des erreurs cryptiques ou se comporte bizarrement ? Le mode debug est votre meilleur allié pour identifier et résoudre ces problèmes. Dans ce guide, je vais vous montrer comment activer ce mode de diagnostic pas à pas, avec des vérifications à chaque étape et des solutions aux erreurs courantes.

Pré-requis et vision d’ensemble

Avant de commencer, voici ce dont vous aurez besoin :

• Un accès FTP ou un gestionnaire de fichiers (comme FileZilla)
• Un éditeur de texte (Notepad++, Visual Studio Code, etc.)
• Un accès à votre fichier wp-config.php
• Un site WordPress en version 5.0 ou supérieure

Le temps nécessaire est d’environ 10 minutes, selon votre familiarité avec ces outils.

Tutoriel pas-à-pas

1. Accéder au fichier wp-config.php

Objectif : Localiser et ouvrir le fichier de configuration principal de WordPress.

1. Connectez-vous à votre serveur via FTP ou utilisez le gestionnaire de fichiers de votre hébergeur
2. Naviguez jusqu’au dossier racine de votre installation WordPress
3. Trouvez le fichier wp-config.php (il se trouve généralement dans le dossier principal)
4. Téléchargez une copie de sauvegarde du fichier avant toute modification

Vérification : Vous devriez voir un fichier nommé wp-config.php avec environ 100 lignes de code.

Erreurs fréquentes :

• Ne pas trouver le fichier ? Vérifiez que vous êtes bien dans le bon dossier racine
• Le fichier est en lecture seule ? Changez les permissions via FTP (755)

2. Activer le mode debug de base

Objectif : Configurer le mode debug pour afficher les erreurs PHP.

1. Ouvrez le fichier wp-config.php dans votre éditeur de texte
2. Ajoutez cette ligne avant / That's all, stop editing! Happy blogging. / :

define( 'WP_DEBUG', true ) 

3. Enregistrez le fichier et téléchargez-le sur votre serveur

Vérification : Actualisez votre site. Si des erreurs PHP apparaissent, le mode debug est activé.

Erreurs fréquentes :

• Le site devient blanc ? Vérifiez que la syntaxe est correcte
• Les erreurs n’apparaissent pas ? Essayez de vider le cache

3. Configurer le mode debug avancé

Objectif : Afficher plus d’informations de débogage et enregistrer les logs.

1. Ajoutez ces lignes après WP_DEBUG :

define( 'WP_DEBUG_LOG', true ) define( 'WP_DEBUG_DISPLAY', false ) @ini_set( 'display_errors', 0 ) 

2. Créez un dossier wp-content/debug.log sur votre serveur
3. Assurez-vous que le fichier est accessible en écriture

Vérification : Les erreurs seront maintenant enregistrées dans debug.log au lieu d’être affichées.

Erreurs fréquentes :

• Le fichier debug.log n’est pas créé ? Vérifiez les permissions (644)
• Trop de logs ? Limitez avec define( 'WP_DEBUG_LOG', true )

4. Activer le mode debug pour les requêtes

Objectif : Analyser les requêtes SQL pour optimiser les performances.

1. Ajoutez cette ligne :

define( 'SAVEQUERIES', true ) 

2. Créez un fichier wp-content/queries.log
3. Ajoutez ce code dans votre thème (fonctions.php) :

if ( defined( 'SAVEQUERIES' ) && SAVEQUERIES ) { add_action( 'shutdown', 'log_queries' ) } function log_queries() { global $wpdb $queries = $wpdb->queries $output = '' foreach ( $queries as $query ) { $output .= sprintf("[%d] %sn", $query[1], $query[0] ) } file_put_contents( WP_CONTENT_DIR . '/queries.log', $output, FILE_APPEND ) }

Vérification : Les requêtes SQL seront enregistrées dans queries.log.

Erreurs fréquentes :

• Le fichier est vide ? Vérifiez que SAVEQUERIES est bien défini
• Trop de données ? Limitez la période d’enregistrement

Bonnes pratiques / Optimisations

Sécurité

Ne laissez jamais le mode debug activé sur un site en production. Utilisez-le uniquement en développement.

Pour les sites en production, utilisez plutôt des plugins comme Query Monitor qui affichent les informations dans l’admin.

Performances

Le mode debug peut ralentir votre site. Désactivez-le dès que vous avez terminé votre diagnostic.

Pour les sites avec beaucoup de trafic, limitez la durée d’enregistrement des logs.

SEO

Les erreurs affichées peuvent nuire à l’expérience utilisateur et au référencement.

Utilisez des outils comme Google Search Console pour identifier les erreurs critiques.

FAQ

1. Puis-je activer le mode debug sur un site en production ?

Non, cela pourrait exposer des informations sensibles. Utilisez-le uniquement en développement.

2. Comment désactiver le mode debug ?

Changez define( 'WP_DEBUG', true ) en define( 'WP_DEBUG', false ) .

3. Où sont stockées les erreurs si WP_DEBUG_DISPLAY est false ?

Dans le fichier wp-content/debug.log si WP_DEBUG_LOG est activé.

4. Comment analyser les logs WordPress ?

Utilisez des outils comme WP Log Viewer ou consultez les fichiers directement.

5. Le mode debug affecte-t-il les performances ?

Oui, il peut ralentir légèrement votre site. Désactivez-le après utilisation.

6. Comment activer le mode debug pour les thèmes et plugins ?

Utilisez define( 'WP_DEBUG', true ) et define( 'WP_DEBUG_LOG', true ) .

7. Que faire si le mode debug ne fonctionne

Que faire si le mode debug ne fonctionne pas ?
Si après avoir suivi ces étapes, le mode debug ne s'active pas ou ne génère pas de logs, voici quelques vérifications supplémentaires :
Vérifiez que vous avez bien enregistré et téléchargé le fichier wp-config.php modifié
Assurez-vous que votre hébergeur ne désactive pas les erreurs PHP
Testez avec un thème et des plugins désactivés pour éliminer les conflits
Consultez les logs serveur (accessibles via votre hébergeur) pour des indices
Activer le mode debug WordPress est une compétence essentielle pour tout administrateur de site. Vous avez maintenant toutes les clés pour identifier et résoudre les problèmes techniques de votre installation. N'oubliez pas de désactiver ce mode une fois votre diagnostic terminé, surtout en environnement de production.
Si vous rencontrez des difficultés persistantes ou si vous souhaitez une assistance professionnelle pour la maintenance de votre site WordPress, notre équipe d'experts est à votre disposition. Contactez-nous au 09 77 29 09 69 69 pour un accompagnement personnalisé. Que ce soit pour optimiser les performances, sécuriser votre site ou résoudre des problèmes complexes, nous mettons notre expertise à votre service.
N'hésitez pas à partager vos retours d'expérience en commentaire ou à poser vos questions. La communauté WordPress est là pour vous aider à chaque étape de votre parcours. Bonne maintenance et à bientôt sur votre site !