Message d’erreur : Your PHP installation appears to be missing the MySQL extension which is required by WordPress.
Cette erreur WordPress apparaît lorsque PHP ne trouve plus l’extension MySQL nécessaire pour communiquer avec la base de données. Elle se produit souvent après une mise à jour de PHP ou lorsque le module mysqli n’est pas activé.
- Type d’erreur : Erreur côté serveur (PHP)
- Causes possibles : extension MySQL absente, WordPress obsolète, version de PHP trop ancienne
- Solution rapide : activez le module
mysqlidans le PHP Selector de votre hébergement, puis vérifiez la version de PHP et mettez WordPress à jour.
Changer de version de PHP est une étape importante pour garder un site WordPress rapide et sécurisé. Mais parfois, après un passage de PHP 8.2 à 8.3 (ou vers une autre version récente), votre site peut se retrouver… complètement en carafe. Au lieu de s’afficher, WordPress bloque sur un message inquiétant :
Please check that the mysqli PHP extension is installed and enabled.
Pas de panique ! Même si le site ne fonctionne plus du tout, ce problème est courant et se résout en quelques clics depuis votre cPanel o2switch.
Pourquoi ce message apparaît-il ?
WordPress a besoin de communiquer avec votre base de données MySQL. Pour cela, il utilise des extensions PHP, en particulier mysqli (ou pdo_mysql). Si, après un changement de version, PHP ne trouve pas cette extension, le site ne peut plus se connecter à la base… et WordPress affiche ce message d’erreur.
La bonne nouvelle : il ne s’agit pas d’un bug de WordPress, ni d’une panne de serveur. C’est simplement une case décochée dans la configuration PHP.
La solution pas à pas
Chez o2switch, tout se règle dans l’interface Sélectionner une version de PHP disponible dans votre cPanel.
- Connectez-vous à votre cPanel.
- Recherchez l’outil Sélectionner une version de PHP.
- Vérifiez que vous utilisez bien la version souhaitée (ex. 8.3).
- Dans la liste des modules, assurez-vous que les extensions suivantes sont cochées :
nd_mysqli(oumysqliselon la version affichée),nd_pdo_mysql(oupdo_mysql).
Pas besoin de sauvegarder, les modules sont activés automatiquement. Dans la grande majorité des cas, le site refonctionne immédiatement.
Et si le problème persiste ?
- Revenez temporairement à la version précédente (par exemple 8.2).
- Vérifiez qu’aucun fichier
php.iniou.user.inipersonnalisé ne désactivemysqli. - Contactez le support o2switch si l’erreur ne disparaît pas. L’équipe vérifiera directement la configuration côté serveur.
Autres erreurs PHP liées à mysqli
Après une mise à jour de PHP, il arrive que WordPress affiche non seulement le message Your PHP installation appears to be missing the MySQL extension, mais aussi des erreurs fatales PHP du type :
Fatal error: Uncaught mysqli_sql_exceptionCall to undefined function mysqli_connect()mysqli_connect(): (HY000/2002): No such file or directory
Dans la majorité des cas, la cause reste la même : le module mysqli est désactivé ou absent. La solution consiste à l’activer via le PHP Selector de votre hébergement, puis à vérifier que vous utilisez bien une version récente de PHP (7.4 ou supérieure).
Bonnes pratiques pour éviter ce genre de surprise
- Tester la nouvelle version PHP en préproduction avant de l’appliquer sur votre site principal.
- Vérifier dans le PHP Selector que les modules indispensables (
mysqli,pdo_mysql) restent bien cochés après une montée de version. - Revenir à la version précédente si l’erreur persiste et demander de l’aide au support.
Cas particulier : le module imagick
Il arrive qu’un autre module, imagick, se décoche aussi lors du changement de version PHP.
- Ce n’est pas bloquant pour WordPress : votre site reste accessible.
- En revanche, l’outil de santé du site peut afficher un message d’avertissement.
- Si vous travaillez beaucoup avec des images (miniatures, PDF, conversions), il est conseillé de réactiver
imagickdepuis le PHP Selector pour retrouver le même comportement qu’avant.
En résumé : cette erreur impressionne, mais la solution est simple. Un petit tour dans le PHP Selector pour cocher mysqli suffit généralement à remettre WordPress en marche.
