Comprendre le problème
Le message « Le plugin a déclenché une erreur fatale » signifie que WordPress a détecté un plantage PHP lors de l'activation de l'extension et a annulé l'opération pour protéger le site. La cause est souvent une incompatibilité PHP, un conflit ou un plugin mal installé.
La piste à vérifier
Lisez le détail de l'erreur affiché par WordPress pour connaître la cause, vérifiez la compatibilité PHP du plugin, réinstallez-le proprement, ou consultez les journaux d'erreur pour aller plus loin.
Comment reconnaître ce bug
- WordPress affiche « Le plugin a déclenché une erreur fatale » à l'activation
- Le plugin refuse de s'activer mais le site reste accessible
- Un détail technique d'erreur PHP accompagne parfois le message
- Un e-mail de récupération est envoyé à l'adresse d'administration
Qu’est-ce que ce bug ?
Depuis la protection contre les erreurs fatales, WordPress teste l'activation d'un plugin et, s'il provoque une erreur fatale PHP, annule l'activation au lieu de laisser le site planter. Le message « Le plugin a déclenché une erreur fatale » est donc une bonne nouvelle : le site reste en ligne. Reste à comprendre pourquoi le code de l'extension échoue.
Pourquoi ce problème apparaît
Incompatibilité avec PHP
Le plugin utilise une syntaxe ou des fonctions absentes de la version de PHP installée.
Conflit avec un autre plugin
Une autre extension active provoque une collision de code à l'activation.
Plugin mal installé
Des fichiers manquants ou corrompus empêchent le plugin de se charger.
Dépendance absente
Le plugin attend un autre composant ou une bibliothèque qui n'est pas présent.
Mémoire PHP insuffisante
L'activation dépasse la limite de mémoire allouée.
Comment réparer ce bug
Conservez une sauvegarde des fichiers et de la base de données. Testez les changements en préproduction lorsque c’est possible. Si vous ne maîtrisez pas une étape, demandez de l’aide avant de l’appliquer.
Lire le message d'erreur
WordPress affiche souvent le fichier et la ligne en cause : notez ces informations.
Consulter les journaux
Activez WP_DEBUG_LOG et ouvrez le fichier debug.log pour obtenir le détail complet de l'erreur.
Vérifier la compatibilité PHP
Comparez la version de PHP requise par le plugin avec celle du serveur, et ajustez-la si besoin.
Réinstaller proprement le plugin
Supprimez le plugin puis réinstallez-le depuis une source officielle pour écarter des fichiers corrompus.
Tester l'isolement du conflit
Désactivez les autres extensions, puis réessayez l'activation pour repérer un conflit.
Comment éviter qu’il revienne
- Vérifiez la version de PHP requise avant d'installer un plugin
- Téléchargez les extensions depuis des sources officielles
- Conservez une marge de mémoire PHP suffisante
- Activez WP_DEBUG_LOG pour disposer des journaux en cas d'erreur
Questions fréquentes
Pourquoi WordPress dit que le plugin a déclenché une erreur fatale ?
Parce qu'il a détecté un plantage PHP lors de l'activation et l'a annulée pour protéger le site. C'est un mécanisme de sécurité, pas une panne du site.
Où trouver le détail de l'erreur fatale ?
Dans le message affiché par WordPress, et surtout dans le fichier debug.log si WP_DEBUG_LOG est activé : il indique le fichier et la ligne fautive.
L'erreur fatale d'un plugin casse-t-elle mon site ?
Non : grâce à la protection contre les erreurs fatales, WordPress annule l'activation et le site reste en ligne. Seul le plugin concerné ne fonctionne pas.
Comment corriger une incompatibilité PHP d'un plugin ?
Vérifiez la version de PHP exigée. Soit vous ajustez la version de PHP du serveur, soit vous utilisez une version du plugin compatible, soit vous changez d'extension.