Comment résoudre l’erreur ‘Cannot redeclare function’ sur WordPress ? Guide complet

Pourquoi l’erreur ‘Cannot redeclare function’ apparaît-elle sur WordPress ?

L’erreur ‘Cannot redeclare function’ est l’une des plus frustrantes pour un propriétaire de site WordPress. Elle survient lorsque deux portions de code tentent de définir une fonction portant le même nom. PHP, le langage serveur de WordPress, ne tolère pas cette redondance et affiche un message d’erreur fatale, rendant souvent le site inaccessible. Ce problème est fréquent lors de l’installation d’un thème ou d’une extension incompatible, après une mise à jour, ou à cause d’un conflit entre deux plugins.

Dans cet article, nous allons explorer en détail les causes de cette erreur, puis vous fournir des solutions concrètes pour la corriger, que vous soyez débutant ou développeur confirmé. Vous apprendrez également à prévenir ce type de conflit à l’avenir.

Comprendre le mécanisme de l’erreur

Pour résoudre l’erreur ‘Cannot redeclare function’, il est essentiel de comprendre son origine. En PHP, chaque fonction doit avoir un nom unique dans le script. Si vous déclarez une fonction déjà existante, PHP interrompt l’exécution et affiche une erreur fatale. WordPress utilise de nombreuses fonctions, à la fois dans le noyau, les thèmes et les extensions. Voici les scénarios les plus courants :

• Conflit entre deux plugins : deux extensions utilisent la même fonction, par exemple ma_fonction_personnalisee().
• Thème obsolète : un thème ancien définit une fonction déjà présente dans WordPress ou dans un plugin récent.
• Fonction déclarée deux fois dans le même fichier : erreur de copier-coller ou de logique dans un fichier functions.php.
• Mise à jour incomplète : après une mise à jour de WordPress, d’un plugin ou d’un thème, des fonctions obsolètes persistent.

Comment identifier la source du problème ?

Avant de modifier quoi que ce soit, il faut localiser le fichier et la ligne exacte où l’erreur se produit. Voici les étapes à suivre :

1. Activer le mode débogage de WordPress

Modifiez le fichier wp-config.php pour afficher les erreurs PHP. Ajoutez ces lignes (remplacez les existantes si besoin) :

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);

Rechargez votre site : l’erreur devrait maintenant indiquer le chemin complet du fichier et le numéro de ligne où la fonction est redéclarée.

2. Examiner les fichiers suspects

Le message d’erreur ressemble à : Fatal error: Cannot redeclare ma_fonction() (previously declared in /chemin/vers/fichier.php:42) in /chemin/vers/autre_fichier.php:10. Notez les deux fichiers et lignes. Le premier fichier est celui où la fonction a été déclarée initialement, le second est le nouvel emplacement qui cause le conflit.

3. Vérifier vos modifications récentes

Si l’erreur est apparue après l’installation d’un plugin ou l’activation d’un thème, désactivez-les via FTP ou phpMyAdmin. Pour désactiver un plugin sans accès admin, renommez son dossier dans /wp-content/plugins/ (par exemple, ajoutez -old).

Solutions pratiques pour corriger l’erreur

Une fois la source identifiée, vous pouvez appliquer l’une des solutions suivantes :

Solution 1 : Supprimer ou commenter la fonction en double

Si vous avez accès au code, ouvrez le fichier incriminé et repérez la fonction. Supprimez la déclaration en double ou commentez-la avec // ou /* ... */. Par exemple, si la fonction ma_fonction() apparaît deux fois, gardez une seule occurrence.

Solution 2 : Utiliser function_exists()

Pour éviter les conflits futurs, enveloppez vos déclarations de fonctions personnalisées dans une condition :

if ( !function_exists( 'ma_fonction' ) ) {
    function ma_fonction() {
        // votre code
    }
}

C’est une bonne pratique recommandée par WordPress. Ainsi, si une autre partie du code déclare la même fonction, la vôtre ne sera pas exécutée.

Solution 3 : Désactiver temporairement les extensions

Si l’erreur persiste, désactivez toutes les extensions et réactivez-les une par une pour isoler le conflit. Utilisez FTP pour renommer le dossier /wp-content/plugins/ en /wp-content/plugins_old/. Cela désactivera tous les plugins. Si le site fonctionne, renommez le dossier d’origine et réactivez les plugins un à un.

Solution 4 : Changer de thème

Passez temporairement à un thème par défaut comme Twenty Twenty-Four. Si l’erreur disparaît, votre thème actuel est en cause. Contactez son développeur ou cherchez une mise à jour.

Prévenir l’erreur à l’avenir

Voici une checklist pour éviter de nouvelles occurrences :

• Utilisez function_exists() pour toutes vos fonctions personnalisées.
• Testez les mises à jour sur un site de staging avant de les déployer.
• Choisissez des extensions et thèmes réputés, régulièrement mis à jour.
• Évitez de modifier directement les fichiers des extensions ; utilisez plutôt un plugin de code personnalisé ou un thème enfant.
• Gardez une sauvegarde récente de votre site pour restaurer rapidement en cas de problème.

Tableau récapitulatif des causes et solutions

Questions fréquentes (FAQ)

1. Que signifie exactement ‘Cannot redeclare function’ ?

C’est une erreur PHP qui se produit lorsque vous essayez de définir une fonction qui a déjà été déclarée. WordPress s’arrête et affiche un message d’erreur fatal.

2. Puis-je corriger l’erreur sans accès à l’administration ?

Oui, via FTP ou le gestionnaire de fichiers de votre hébergeur. Vous pouvez désactiver les plugins en renommant leur dossier, ou modifier le fichier functions.php du thème.

3. L’erreur peut-elle endommager ma base de données ?

Non, elle n’affecte que l’exécution du code PHP. Votre base de données reste intacte. Une fois le code corrigé, le site fonctionne normalement.

4. Comment utiliser function_exists() correctement ?

Placez la condition autour de la définition de votre fonction. Exemple : if ( !function_exists( 'ma_fonction' ) ) { function ma_fonction() { ... } }. Cela évite les conflits.

5. Que faire si l’erreur persiste après toutes ces étapes ?

Contactez votre hébergeur ou un développeur. Il se peut qu’un fichier du noyau WordPress soit corrompu. Téléchargez une nouvelle copie de WordPress et remplacez les fichiers.

Recommandations finales

L’erreur ‘Cannot redeclare function’ est souvent le signe d’un conflit de code. En adoptant les bonnes pratiques comme l’utilisation de function_exists() et en maintenant vos extensions à jour, vous réduirez considérablement les risques. N’oubliez pas de toujours tester les modifications sur un environnement de staging avant de les appliquer sur votre site en production. Si vous rencontrez cette erreur, restez méthodique : identifiez la source, appliquez la solution adaptée, puis prévenez les récidives. Votre site WordPress vous remerciera.

Photo by Annushka Ahuja on Pexels