Comprendre le problème
Un plugin incompatible avec la version de PHP utilise une syntaxe ou des fonctions absentes — ou supprimées — de cette version. Le résultat est une erreur fatale, une page blanche ou des avertissements. Cela arrive après une montée de version de PHP ou avec un plugin non maintenu.
La piste à vérifier
Vérifiez la version de PHP exigée par le plugin, mettez l'extension à jour, ajustez la version de PHP du serveur, ou remplacez le plugin par une alternative compatible et maintenue.
Comment reconnaître ce bug
- Une erreur fatale ou une page blanche est apparue après un changement de version de PHP
- Le journal d'erreur signale une fonction inconnue ou une erreur de syntaxe
- Le plugin affiche un avertissement de compatibilité PHP
- Une extension ancienne et non maintenue refuse de fonctionner
Qu’est-ce que ce bug ?
Chaque version de PHP ajoute des fonctions et en retire d'obsolètes. Un plugin écrit pour une version ancienne peut s'appuyer sur du code disparu ; un plugin récent peut exiger une syntaxe absente d'une vieille version. L'incompatibilité se manifeste alors par une erreur fatale ou des avertissements. C'est un point sensible lors des montées de version de PHP imposées par les hébergeurs.
Pourquoi ce problème apparaît
Montée de version de PHP
L'hébergeur a relevé la version de PHP et l'ancien code du plugin n'est plus valide.
Fonctions supprimées
Le plugin utilise des fonctions dépréciées puis retirées des versions récentes de PHP.
Syntaxe trop récente
Un plugin moderne exige une syntaxe absente d'une version de PHP trop ancienne.
Plugin non maintenu
L'extension n'est plus mise à jour et n'a pas suivi l'évolution de PHP.
Version de PHP non précisée
Le plugin n'indique pas clairement la version de PHP requise, d'où une installation hasardeuse.
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.
Identifier la version de PHP en place
Consultez Outils > Santé du site ou le panneau de l'hébergeur pour connaître la version de PHP active.
Lire les journaux d'erreur
Activez WP_DEBUG_LOG : le fichier debug.log précise la fonction ou la syntaxe en cause.
Mettre le plugin à jour
Installez la dernière version du plugin : elle est souvent compatible avec les versions récentes de PHP.
Ajuster la version de PHP
Si le plugin est essentiel et ancien, repassez temporairement à une version de PHP compatible.
Remplacer le plugin
Si l'extension n'est plus maintenue, adoptez une alternative à jour et activement développée.
Comment éviter qu’il revienne
- Vérifiez la version de PHP requise avant d'installer un plugin
- Testez la compatibilité avant toute montée de version de PHP
- Évitez les extensions non maintenues depuis longtemps
- Surveillez les avertissements de compatibilité dans la Santé du site
Questions fréquentes
Comment savoir quelle version de PHP utilise mon site ?
Rendez-vous dans Outils > Santé du site, onglet Informations, section Serveur ; le panneau de votre hébergeur affiche aussi la version de PHP active.
Que faire si un plugin essentiel est incompatible avec PHP ?
Cherchez d'abord une mise à jour du plugin. À défaut, revenez à une version de PHP compatible, ou remplacez l'extension par une alternative maintenue.
Une mise à jour de PHP peut-elle casser des plugins ?
Oui : si un plugin ancien utilise du code retiré des nouvelles versions de PHP, il peut planter. D'où l'intérêt de tester avant toute montée de version.
Comment connaître la version de PHP requise par un plugin ?
La page du plugin et son fichier de description (« Requires PHP ») indiquent la version minimale. Si l'information manque, c'est souvent le signe d'une extension peu maintenue.