« Your PHP installation appears to be missing the MySQL extension » : la solution

Fiche du décodeur d'erreurs, mise à jour le 12 octobre 2026

BloquantErreurs PHP
Le message affiché
Your PHP installation appears to be missing the MySQL extension which is required by WordPress.
Autres formulations du même message 2
  • Votre installation PHP ne dispose pas de MySQL. Extension requise pour WordPress.
  • Please check that the mysqli PHP extension is installed and enabled.

WordPress dialogue avec sa base de données grâce à l’extension mysqli de PHP. Ici, la version de PHP qui exécute le site ne la charge pas, alors WordPress s’arrête avant même de se connecter. Vos contenus ne sont pas en cause : c’est un réglage du serveur, ou un WordPress très ancien qui ne sait pas utiliser mysqli.

Pourquoi cette erreur apparaît

  • La version de PHP a été changée dans l’espace client et l’extension mysqli n’est pas cochée pour cette nouvelle version.
  • Un WordPress très ancien, qui ne connaît que l’extension mysql retirée de PHP 7, tourne sur un serveur à jour.
  • Sur un serveur dédié, un VPS ou une installation locale, le module MySQL de PHP n’est pas installé pour la version utilisée.
  • Un fichier php.ini personnalisé empêche le chargement de l’extension.

Comment corriger le problème

Contrôler la version de PHP choisie

Si l’erreur est apparue après un changement de version de PHP, ouvrez le réglage PHP de votre hébergement. Revenir provisoirement à la version précédente remet en général le site en ligne, le temps de configurer correctement la nouvelle.

Cocher l’extension mysqli

Dans les sélecteurs de version PHP (cPanel, Plesk et la plupart des offres mutualisées), une liste d’extensions accompagne chaque version. Cochez mysqli, nommée nd_mysqli sur certains serveurs, enregistrez puis rechargez le site. Si votre hébergeur ne propose pas ce choix, son support peut l’activer.

Vérifier l’âge de WordPress

Ouvrez le fichier wp-includes/version.php : la ligne $wp_version donne la version installée. Une version très ancienne ne fonctionne pas avec PHP 7 ou 8. Il faut alors mettre WordPress à jour à la main, après une sauvegarde complète, en remplaçant ses fichiers par ceux d’une archive récente.

Installer le module sur un serveur

Sur un VPS Debian ou Ubuntu, installez le paquet MySQL de votre version de PHP, puis redémarrez PHP-FPM ou Apache. La commande php -m doit ensuite lister mysqli ; vérifiez quand même la version utilisée par le site web, qui peut différer de celle de la ligne de commande.

sudo apt install php8.3-mysql
sudo systemctl restart php8.3-fpm
php -m | grep -i mysqli

Le cas d’un fichier db.php

Si l’erreur parle d’une fonction mysqli_ non définie, un fichier wp-content/db.php, laissé par une extension de cache ou de diagnostic, court-circuite la vérification de WordPress. La solution reste d’activer mysqli ; renommer db.php sert seulement à retrouver le message explicite.

Faites une sauvegarde complète avant de changer de version de PHP ou de mettre WordPress à jour : sur un site ancien, un saut de plusieurs versions peut révéler d’autres incompatibilités.

Un autre message d'erreur ? Collez-le dans le décodeur : il le reconnaît et vous oriente vers la bonne fiche.

Ouvrir le décodeur