Comment résoudre l’erreur ‘Use of undefined constant’ sur WordPress ? Guide complet

Comprendre l’erreur ‘Use of undefined constant’ sur WordPress

Si vous voyez soudainement un message comme Use of undefined constant WP_DEBUG – assumed ‘WP_DEBUG’ sur votre site WordPress, ne paniquez pas. Cette erreur est fréquente et généralement facile à résoudre. Elle apparaît lorsque PHP rencontre une constante non définie, souvent à cause d’une faute de syntaxe dans un fichier de configuration ou un thème. Dans cet article, nous allons explorer les causes principales et vous fournir des solutions pas à pas.

Pourquoi cette erreur se produit-elle ?

L’erreur ‘Use of undefined constant’ survient principalement pour trois raisons :

• Absence de guillemets autour d’une chaîne de caractères : PHP interprète alors le texte comme une constante.
• Fichier wp-config.php mal formaté : une ligne de configuration incorrecte peut déclencher l’erreur.
• Problème dans un fichier de thème ou d’extension : du code obsolète ou mal écrit.

L’erreur se manifeste souvent lors de l’activation d’un nouveau thème, d’une mise à jour de WordPress ou après une modification manuelle du fichier wp-config.php.

Les causes courantes détaillées

1. Absence de guillemets dans wp-config.php

Le fichier wp-config.php contient des définitions de constantes comme define('WP_DEBUG', true). Si vous oubliez les guillemets autour du nom de la constante, par exemple :

define(WP_DEBUG, true);

PHP lèvera une erreur car WP_DEBUG sans guillemets est interprété comme une constante. La solution est simple : ajoutez des guillemets simples ou doubles.

2. Erreur de syntaxe dans un fichier PHP

Parfois, un thème ou une extension utilise une constante sans la définir au préalable. Par exemple :

if (MY_THEME_VERSION > 2) { ... }

Si MY_THEME_VERSION n’est pas défini avec define(), l’erreur apparaît. Vérifiez le code du thème ou de l’extension concernée.

3. Fichier de cache ou d’optimisation corrompu

Certains plugins de cache ou de minification génèrent des fichiers PHP mal formatés. Une mise à jour récente peut introduire une constante non définie.

Comment diagnostiquer l’origine de l’erreur ?

Avant de corriger, il faut identifier le fichier incriminé. L’erreur PHP inclut généralement le chemin du fichier et le numéro de ligne. Par exemple :

Notice: Use of undefined constant WP_DEBUG - assumed 'WP_DEBUG' in /var/www/html/wp-config.php on line 25

Dans ce cas, le problème est à la ligne 25 de wp-config.php. Si l’erreur pointe vers un fichier de thème, connectez-vous en FTP et ouvrez ce fichier.

Solutions pas à pas

Solution 1 : Vérifier et corriger wp-config.php

Le fichier wp-config.php est souvent en cause. Accédez-le via FTP ou le gestionnaire de fichiers de votre hébergement. Recherchez les lignes contenant define(. Assurez-vous que le nom de la constante est entre guillemets. Exemple correct :

define('WP_DEBUG', false);
define('DB_NAME', 'votre_base');

Si vous voyez define(WP_DEBUG, false);, remplacez par define('WP_DEBUG', false);. Enregistrez et rechargez votre site.

Solution 2 : Désactiver les plugins suspects

Si l’erreur vient d’une extension, désactivez-la temporairement. Pour cela :

1. Connectez-vous à votre tableau de bord WordPress (si accessible) ou via FTP.
2. Renommez le dossier du plugin dans /wp-content/plugins/ (par exemple, mon-plugin en mon-plugin-desactive).
3. Vérifiez si l’erreur disparaît. Si oui, mettez à jour le plugin ou contactez son développeur.

Solution 3 : Revenir à un thème par défaut

Un thème mal codé peut provoquer l’erreur. Basculez temporairement vers un thème WordPress officiel (Twenty Twenty-Four par exemple). Via FTP, renommez le dossier de votre thème actuel dans /wp-content/themes/. WordPress utilisera alors un thème par défaut. Si l’erreur disparaît, le problème vient de votre thème.

Solution 4 : Vider le cache

Si vous utilisez un plugin de cache, videz-le. Certains plugins génèrent des fichiers PHP mis en cache qui peuvent contenir des constantes non définies. Allez dans Réglages > Cache et videz tout le cache.

Solution 5 : Vérifier les fichiers récemment modifiés

Si l’erreur est apparue après une modification, examinez les fichiers que vous avez édités. Utilisez un outil de comparaison (comme diff) pour repérer les changements. Rétablissez la version précédente si nécessaire.

Tableau récapitulatif des causes et solutions

Prévenir l’erreur à l’avenir

Pour éviter de revivre cette situation, suivez ces bonnes pratiques :

• Toujours mettre à jour WordPress, les thèmes et les extensions : les versions récentes corrigent les bugs.
• Utiliser un environnement de développement pour tester les modifications avant de les appliquer en production.
• Éditer les fichiers avec un éditeur de code fiable qui met en évidence les erreurs de syntaxe.
• Sauvegarder régulièrement votre site : cela permet de restaurer une version fonctionnelle rapidement.

Checklist de dépannage rapide

• [ ] Identifier le fichier et la ligne dans le message d’erreur.
• [ ] Vérifier les guillemets dans wp-config.php.
• [ ] Désactiver tous les plugins via FTP.
• [ ] Revenir au thème par défaut.
• [ ] Vider le cache du site et du navigateur.
• [ ] Restaurer une sauvegarde récente si nécessaire.

Questions fréquentes sur l’erreur ‘Use of undefined constant’

Recommandations pour un site WordPress sain

L’erreur ‘Use of undefined constant’ est un signal d’alarme. En la corrigeant rapidement, vous améliorez la stabilité de votre site. Adoptez une routine de maintenance : mises à jour régulières, sauvegardes automatiques et tests après chaque modification. Si vous n’êtes pas à l’aise avec le code, faites appel à un professionnel.

N’oubliez pas que la résolution de cette erreur passe souvent par une simple vérification des guillemets. Prenez le temps d’examiner votre fichier wp-config.php et vos fichiers de thème. Votre site vous remerciera.

Photo by Alexas_Fotos on Pixabay