Comment résoudre le problème « Votre installation PHP semble ne pas inclure l'extension MySQL » dans WordPress ?

Si vous avez déjà tenté d'installer ou de charger WordPress et rencontré l'erreur « Votre installation PHP semble ne pas inclure l'extension MySQL requise par WordPress », sachez que vous n'êtes pas seul. Cette erreur d' bloque votre site et peut paraître insurmontable au premier abord.

La bonne nouvelle, c'est qu'il s'agit presque toujours d'un problème de configuration du pilote PHP MySQL ou du serveur. En suivant les bonnes étapes, vous pouvez le résoudre sans connaissances techniques approfondies.

En bref : Extension MySQL manquante : ce que vous devez savoir

• PHP ne trouve pas le pilote de base de données nécessaire pour communiquer avec MySQL, ce qui empêche le chargement de WordPress. Il s'agit d'une erreur d'extension PHP non chargée au niveau du serveur.

• L'erreur est généralement déclenchée par une mise à jour de PHP, une migration de serveur ou un fichier php.ini mal configuré, ce qui entraîne le déchargement du site WordPress pour tous les visiteurs.

• L'activation de l'extension MySQLi ou PDO_MySQL dans PHP résout le problème dans la plupart des cas.

• Si les modifications au niveau du serveur vous mettent mal à l'aise, votre fournisseur d'hébergement peut appliquer la correction rapidement.

Aperçu de l'erreur « Votre installation PHP semble ne pas inclure l'extension MySQL » dans WordPress

Cette erreur se produit lorsque WordPress ne parvient pas à se connecter à la base de données car une extension MySQL requise est manquante ou désactivée dans votre configuration PHP.

Que signifie le message d'erreur dans WordPress ?

Le message d'erreur complet est le suivant : « Il semble que votre installation PHP ne dispose pas de l'extension MySQL requise par WordPress. »

En clair, PHP ne trouve pas la bibliothèque nécessaire à la communication avec votre base de données MySQL. Cette absence d'extension PHP provoque une erreur de base de données WordPress avant même que le contenu puisse s'afficher.

Sans cette connexion, WordPress ne peut charger aucun contenu, paramètre ou partie de votre site. L'ensemble du site web devient inaccessible.

Il ne s'agit pas d'un bug de WordPress, mais d'un problème au niveau du serveur. WordPress détecte simplement le composant manquant et le signale.

Exemple de message d'erreur relatif à une extension MySQL manquante

Lorsque cette erreur se produit, vous voyez généralement l'un des messages suivants sur un écran blanc. Cet écran blanc WordPress ne comporte souvent aucune autre explication :

• « Il semble que votre installation PHP ne comprenne pas l'extension MySQL, requise par WordPress. »

• « Nous n'avons pas pu nous connecter à MySQL. »

• « Impossible de sélectionner la base de données. »

Ces messages s'affichent généralement avant le chargement du panneau d'administration WordPress. Vous pouvez également rencontrer cette erreur lors d'une nouvelle installation de WordPress, lorsque le script d'installation ne parvient pas à se connecter à la base de données.

Pourquoi cette erreur bloque-t-elle votre site WordPress ?

WordPress fonctionne entièrement grâce à une base de données. Chaque chargement de page déclenche une requête PHP vers votre base de données MySQL. Une connexion MySQL interrompue empêche WordPress d'effectuer les opérations suivantes :

• Récupérer les articles, les pages, les catégories ou les commentaires.
• Chargez les paramètres et les configurations des widgets de votre thème actif.
• Authentifier les connexions utilisateur.
• Exécuter les fonctionnalités de tout plugin installé.

Le résultat est un site web totalement inutilisable. Les visiteurs voient un écran d'erreur au lieu de votre contenu.

Relation entre PHP, MySQL et la connexion à la base de données WordPress

PHP est le langage de script qui alimente WordPress. MySQL est la base de données relationnelle qui stocke toutes les données de votre site : articles, utilisateurs, paramètres, données des extensions, etc.

Ces deux systèmes communiquent via une extension PHP qui sert d'interface. WordPress gère cela en interne grâce à sa couche d'abstraction de base de données, la classe wpdb.

À chaque fois qu'un visiteur accède à votre site, PHP envoie des requêtes à MySQL via la classe wpdb, récupère les données pertinentes et affiche les résultats sous forme de page HTML. Si l'extension PHP requise pour cette communication est manquante ou désactivée, le processus échoue.

WordPress vérifie la présence de cette extension au démarrage. S'il ne la trouve pas, il génère immédiatement une erreur « extension MySQL manquante ».

Comparaison des différences entre MySQL, MySQLi et PDO : MySQL expliqué

Trois extensions PHP permettent de gérer les connexions aux bases de données MySQL :

• MySQL: L’extension MySQL d’origine pour PHP. Elle a été dépréciée dans PHP 5.5 et définitivement supprimée dans PHP 7.0. WordPress a cessé de la prendre en charge simultanément. Si votre serveur exécute PHP 7.0 ou une version ultérieure (ce qui est recommandé), cette extension est tout simplement indisponible. Son utilisation n’a jamais été une solution viable à long terme.

• MySQLi: Extension MySQL « améliorée » (le « i » signifie « améliorée »). Vous pouvez activer MySQLi en PHP via le fichier php.ini ou votre panneau de contrôle d’hébergement. Elle prend en charge les styles de programmation orientée objet et procédurale. Elle ajoute également des fonctionnalités telles que les requêtes préparées et les requêtes multiples. WordPress utilise MySQLi par défaut lorsqu’il est disponible.

• PDO_MySQL: PHP Data Objects est une interface de base de données plus abstraite. Elle prend en charge plusieurs systèmes de bases de données via une API unique et cohérente. WordPress peut utiliser PDO_MySQL comme solution de repli lorsque MySQLi est indisponible.

WordPress moderne requiert l'installation et l'activation de MySQLi ou de PDO_MySQL. En l'absence de l'un ou de l'autre, une erreur d'extension MySQL manquante s'affiche immédiatement.

Qu’est-ce qui provoque l’erreur « Extension MySQL manquante » dans WordPress ?

Plusieurs scénarios distincts peuvent déclencher cette erreur. Identifier la cause première est la première étape vers une solution adéquate.

• Mise à jour de PHP sans conservation des extensions : lors d'une mise à jour de PHP, par exemple de PHP 7.4 à PHP 8.1 ou 8.2, la nouvelle installation peut ne pas inclure automatiquement toutes les extensions précédemment actives. Le paquet php-mysqli doit souvent être réinstallé séparément. L'extension MySQLi peut être omise de la nouvelle installation, même si elle était active dans l'ancienne. Il s'agit d'une des causes les plus fréquentes d'erreurs en environnement de production.

• Migration de serveur : Le transfert de votre site WordPress vers un nouveau serveur ou le changement d’hébergeur peut entraîner une configuration incorrecte de votre environnement PHP. Toutes les configurations serveur n’activent pas MySQLi par défaut. Le nouveau serveur peut exécuter PHP sans MySQLi.

• Fichier php.ini corrompu ou incomplet : Le fichier php.ini contrôle tous les aspects de votre environnement PHP, notamment les extensions chargées et leur emplacement via la extension_dir . Si ce fichier est corrompu, incomplet ou s’il manque la ligne d’extension MySQLi correcte, PHP générera une erreur au démarrage et WordPress ne pourra pas trouver le pilote nécessaire.

• Plusieurs versions de PHP peuvent s'exécuter simultanément. Certains serveurs exécutent plusieurs versions de PHP en parallèle. Si WordPress utilise une version incorrecte de PHP, par exemple une version dépourvue de MySQLi, cette erreur s'affichera même si d'autres sites hébergés sur le même serveur fonctionnent correctement. Ce conflit de versions PHP est facile à manquer, car le panneau de contrôle de l'hébergement peut afficher la version correcte alors que le serveur web en utilise une différente.

• Installation récente sur un serveur personnalisé : les nouvelles installations WordPress sur des serveurs locaux configurés sur mesure, tels que XAMPP, MAMP, Laragon ou des conteneurs Docker, ne parviennent souvent pas à activer MySQLi par défaut. Les développeurs qui configurent des environnements locaux rencontrent fréquemment ce problème car l’extension php-mysqli doit être activée manuellement dans la plupart des configurations par défaut de XAMPP et MAMP.

• Modifications de la configuration du fournisseur d'hébergement : Les fournisseurs d'hébergement modifient parfois la configuration des serveurs lors des opérations de maintenance ou des mises à niveau de l'infrastructure. Ces modifications peuvent désactiver par inadvertance des extensions précédemment actives.

Méthodes pour corriger l'erreur d'extension MySQL manquante dans WordPress

Vous pouvez résoudre ce problème en activant l'extension MySQL, en mettant à jour PHP ou en corrigeant les paramètres de configuration de votre serveur.

Méthode 1 : Installer ou activer l’extension MySQLi dans PHP

Voici la solution la plus directe. Sur un serveur Linux, vous pouvez installer l'extension MySQLi à l'aide de votre gestionnaire de paquets. Ce paquet s'appelle généralement php-mysqli sur les systèmes basés sur Debian.

Pour Ubuntu ou Debian (installer php-mysqli) :

sudo apt install php-mysqli sudo service apache2 restart

Pour CentOS ou RHEL :

sudo yum install php-mysqli sudo systemctl restart httpd

Après l'installation, redémarrez votre serveur web. Rechargez ensuite votre site WordPress pour vérifier si l'erreur a disparu.

Si vous utilisez un hébergement mutualisé, recherchez la section « Extensions PHP » ou « Sélectionner les extensions PHP » dans votre panneau de contrôle (cPanel, Plesk ou équivalent). Trouvez mysqli dans la liste, activez-le, puis enregistrez. La modification est généralement prise en compte immédiatement.

Méthode 2 : Vérifier et mettre à jour ou rétrograder la version de PHP

Une version incompatible de PHP est une cause fréquente de problème. WordPress recommande officiellement PHP 8.1 ou une version supérieure.

L'utilisation d'une version non prise en charge, notamment une version à laquelle il manque des extensions essentielles, provoque cette erreur. PHP 8.1 et PHP 8.2 incluent tous deux MySQLi par défaut sur les serveurs correctement configurés.

Pour vérifier et modifier votre version PHP :

• Connectez-vous à votre panneau de contrôle d'hébergement.

• Recherchez « Version PHP », « Gestionnaire MultiPHP » ou une option similaire (dans cPanel, cela se trouve sous « Logiciel »).

• Passez à PHP 8.1 ou 8.2, qui incluent tous deux MySQLi par défaut.

Si une mise à jour récente a rendu votre site inaccessible, vous pouvez temporairement revenir à la version précédente le temps d'enquêter. Certains hébergeurs permettent de choisir la version PHP pour chaque domaine.

Il est impératif de tester les modifications de version PHP sur un environnement de test avant de les appliquer en production. Une incompatibilité de version peut entraîner des dysfonctionnements des plugins et des thèmes, ainsi que des erreurs de base de données.

Méthode 3 : Mettre à jour le noyau WordPress, les thèmes et les plugins

Des fichiers principaux, des thèmes ou des plugins obsolètes peuvent parfois déclencher des erreurs de compatibilité, y compris des défaillances au niveau de la couche de base de données PHP.

WordPress met régulièrement à jour sa classe d'abstraction de base de données interne (wpdb) pour prendre en charge les versions PHP plus récentes et les exigences de compatibilité MySQL.

Pour mettre à jour WordPress :

• Accédez à Tableau de bord → Mises à jour dans votre panneau d'administration.
• Cliquez sur « Mettre à jour maintenant » pour le noyau WordPress.
• Mettez ensuite à jour tous les plugins et thèmes actifs.

Si vous ne pouvez pas accéder au panneau d'administration en raison d'une erreur, effectuez une mise à jour via FTP en téléchargeant les fichiers WordPress les plus récents directement depuis WordPress.org. Cette méthode permet de mettre à jour les fichiers principaux sans modifier le dossier wp-content.

Effectuez toujours une sauvegarde complète de votre site et de votre base de données avant toute mise à jour. Cela protège vos données en cas de problème pendant le processus.

Méthode 4 : Vérifier la configuration PHP à l’aide de phpinfo()

La phpinfo() génère un rapport détaillé de l'environnement PHP de votre serveur. Utiliser phpinfo() pour vérifier si MySQLi ou PDO_MYSQL est chargé sur WordPress est l'un des moyens les plus rapides.

• Créez un nouveau fichier nommé info.php dans le répertoire racine de votre installation WordPress.
• Ajoutez cette simple ligne : <?php phpinfo(); ?>
• Rendez-vous sur votredomaine.com/info.php dans votre navigateur.
• Utilisez CTRL+F pour rechercher « mysqli » ou « pdo_mysql » dans le résultat.

Si une section intitulée « mysqli » apparaît avec l'état « activé », l'extension est chargée. Si elle est absente, l'extension est manquante et doit être ajoutée.

Note de sécurité : Supprimez immédiatement le info.php après votre vérification. Le laisser accessible expose des données de configuration serveur détaillées à toute personne visitant l’URL.

Méthode 5 : Résoudre les problèmes de configuration du fichier php.ini

Le fichier php.ini détermine les extensions PHP chargées au démarrage. Un point-virgule (ou caractère de commentaire) au début de la ligne d'extension empêchera son chargement. La ligne recherchée est : extension=mysqli.

• Accédez à votre serveur via FTP ou SSH.
• Localisez votre fichier php.ini. Les chemins courants incluent /etc/php/8.1/apache2/php.ini ou /etc/php.ini.
• Recherchez la ligne : ;extension=mysqli
• Supprimez le point-virgule pour décommenter la ligne : extension=mysqli
• Enregistrez le fichier et redémarrez votre serveur web.

Si votre hébergeur restreint l'accès direct au fichier php.ini, créez un .user.ini à la racine de votre installation WordPress. Ajoutez- la ligne « extension=mysqli » et enregistrez-le. PHP détectera automatiquement ce .user.ini sur la plupart des plateformes d'hébergement mutualisé.

Méthode 6 : Résoudre les conflits entre plusieurs versions de PHP

Sur les serveurs exécutant plusieurs versions de PHP, WordPress peut être associé à la mauvaise version. Si cette version ne prend pas en charge MySQLi, l'erreur se produit.

Pour résoudre ce problème :

• Vérifiez quelle version de PHP votre site utilise (via phpinfo() comme décrit dans la méthode 4).

• Dans cPanel, ouvrez MultiPHP Manager et attribuez la version PHP correcte à votre domaine.

• Ouvrez la section « Extensions PHP » et assurez-vous mysqli est activé pour cette version spécifique.

Sur un serveur autogéré, utilisez `php -v` dans le terminal pour vérifier la version active et `php -m | grep mysqli` pour confirmer si MySQLi est chargé pour ce binaire. Si `php -m | grep mysqli` ne renvoie rien, l'extension est manquante pour cette version.

Méthode 7 : Réinstaller PHP et les extensions requises

Si l'activation de MySQLi échoue, il est possible que l'installation de PHP soit corrompue. Une réinstallation propre de PHP et du module mysqli résout ce problème.

Sous Ubuntu ou Debian :

sudo apt purge php8.1 php8.1-mysql sudo apt install php8.1 php8.1-mysqli sudo service apache2 restart

Sur CentOS ou RHEL :

sudo yum remove php php-mysql sudo yum install php php-mysqli sudo systemctl restart httpd

Après la réinstallation, exécutez la commande `php -m | grep mysqli` dans votre terminal pour vérifier que l'extension est bien active. Vous devriez voir « mysqli » dans le résultat.

Méthode 8 : Vérifier la configuration de la pile serveur (Apache ou Nginx et MySQL)

Votre serveur web doit acheminer correctement les requêtes PHP vers l'interpréteur PHP approprié. Une mauvaise configuration à ce niveau peut empêcher le chargement des extensions, même si elles sont installées.

• Pour Apache : vérifiez que mod_php ou php-fpm est correctement configuré. Apache mod_php charge PHP directement comme un module, tandis que PHP-FPM s'exécute comme un processus distinct. Vérifiez la configuration de votre VirtualHost pour vous assurer que le gestionnaire PHP approprié est bien configuré.

• Pour Nginx : Nginx n’exécute pas PHP nativement et requiert toujours PHP-FPM. Vérifiez que la `fastcgi_pass` dans votre configuration serveur pointe vers le fichier socket PHP-FPM approprié. Assurez-vous que le pool PHP-FPM utilise la version compatible avec MySQLi.

Après toute modification, redémarrez à la fois le serveur web et PHP-FPM :

sudo systemctl restart nginx sudo systemctl restart php8.1-fpm

Lire la suite : Apache vs Nginx : lequel est le meilleur pour héberger WordPress ?

Méthode 9 : Contactez votre fournisseur d’hébergement pour obtenir de l’aide

Si l'une des méthodes ci-dessus vous semble trop technique, votre hébergeur est la solution la plus rapide. La plupart des hébergeurs WordPress gérés prennent en charge les problèmes d'extensions PHP en quelques minutes dans le cadre de leur assistance standard.

Lorsque vous contactez l'assistance, veuillez inclure :

• Voici le message d'erreur exact que vous voyez.

• La version PHP actuellement utilisée par votre site (provenant de phpinfo ou de cPanel).

• Lorsque l'erreur est apparue pour la première fois, après une mise à jour, une migration ou une maintenance du serveur.

Les fournisseurs qui proposent un hébergement WordPress géré prennent en charge pour vous les configurations PHP au niveau du serveur, y compris la prise en charge des extensions PHP.

Sur un hébergement mutualisé, l'équipe d'assistance peut activer MySQLi côté serveur sans nécessiter aucune action de votre part.

Dépannage avancé de l'erreur d'extension MySQL manquante dans WordPress

Si les méthodes standard ci-dessus n'ont pas permis de résoudre l'erreur, ces techniques avancées peuvent aider à identifier le problème.

Vérifiez votre fichier wp-config.php. Même avec MySQLi installé, des identifiants de base de données incorrects dans votre fichier wp-config.php empêcheront la connexion. Ouvrez wp-config.php et vérifiez les paramètres de base de données suivants :

define( 'DB_NAME', 'nom_de_votre_base_de_données' ); define( 'DB_USER', 'nom_d_utilisateur_de_votre_base_de_données' ); define( 'DB_PASSWORD', 'mot_de_passe_de_votre_base_de_données' ); define( 'DB_HOST', 'localhost' );

Une valeur incorrecte dans l'un de ces champs, notamment DB_HOST, peut générer des erreurs qui, à première vue, ressemblent à des erreurs d'extension manquante.

Certains fournisseurs d'hébergement utilisent un nom d'hôte spécifique au lieu de localhost, et l'utilisation d'une valeur incorrecte bloque la connexion même lorsque MySQLi est correctement installé.

Activez le mode débogage de WordPress. Ajoutez ces lignes à votre wp-config.php pour activer le rapport d'erreurs détaillé. WP_DEBUG_LOG enregistre toutes les erreurs dans un fichier au lieu de les afficher publiquement :

définir( 'WP_DEBUG', vrai ); définir( 'WP_DEBUG_LOG', vrai ); définir( 'WP_DEBUG_DISPLAY', faux );

Le fichier WP_DEBUG_LOG est enregistré dans wp-content/debug.log. Recherchez dans ce fichier les messages relatifs aux extensions PHP ou les erreurs de démarrage de PHP. Les lignes mentionnant mysqli_connect, un appel à une fonction non définieou des noms de modules manquants indiquent directement un problème d'extension.

Consultez les journaux d'erreurs du serveur. Apache stocke ces journaux dans /var/log/apache2/error.log. Nginx utilise /var/log/nginx/error.log. Ces journaux d'erreurs serveur indiquent souvent la raison exacte pour laquelle une extension PHP n'a pas pu être chargée, par exemple une bibliothèque partagée manquante, un chemin d'accès incorrect à extension_dir ou un problème d'autorisation empêchant la lecture de l'extension.

Vérifiez la présence de logiciels de sécurité incompatibles. Les pare-feu d'applications web (WAF), les antivirus serveur et les extensions de sécurité WordPress trop strictes peuvent parfois perturber le chargement des extensions PHP ou bloquer les requêtes de connexion à la base de données. Désactivez-les temporairement et réessayez. Si l'erreur disparaît, le problème venait de l'outil de sécurité. Réactivez-le et autorisez le port de connexion à la base de données (généralement 3306) pour rétablir la protection sans conflit.

Effectuez vos tests dans un environnement de test. Ne testez jamais les modifications apportées au serveur directement sur un site en production. Utilisez un environnement de test pour appliquer et vérifier les correctifs avant de les déployer en production. La plupart des fournisseurs d'hébergement géré incluent un environnement de test dans leurs offres.

Bonnes pratiques pour éviter les erreurs d'extension MySQL dans WordPress

Mieux vaut prévenir que guérir. Ces pratiques réduisent la probabilité que cette erreur apparaisse sur votre site WordPress.

• Assurez-vous que votre version de PHP est à jour et compatible avec les exigences de WordPress. Utilisez toujours une version de PHP conforme aux recommandations actuelles de WordPress (PHP 8.1 ou version ultérieure, en 2024-2025). Lors de la mise à jour de PHP, vérifiez que toutes les extensions requises, MySQLi et PDO_MySQL sont bien incluses dans la nouvelle installation. Consultez la page officielle des exigences PHP de WordPress avant chaque mise à jour.

• Testez les mises à jour PHP sur un site de test. Avant de mettre à jour PHP sur votre site en production, exécutez la nouvelle version dans un environnement de test. Effectuez un test de compatibilité PHP avec WordPress à l'aide d'outils comme l'extension PHP Compatibility Checker. Assurez-vous que MySQLi se charge correctement et que tous les plugins et thèmes restent compatibles avant de déployer les modifications en production.

• Optez pour un hébergement WordPress géré. Les fournisseurs d'hébergement géré prennent en charge automatiquement la configuration PHP au niveau du serveur. Ils maintiennent PHP et ses extensions à jour et correctement configurés, réduisant ainsi considérablement les risques d'erreur.

• Effectuez des sauvegardes régulières de votre site. Conservez toujours des sauvegardes à jour de vos fichiers WordPress et de votre base de données. Si une modification du serveur provoque cette erreur, une sauvegarde vous permettra de rétablir un état fonctionnel pendant que vous corrigez le problème à la source.

• Surveillez la disponibilité de votre site. La surveillance en temps réel de la disponibilité de WordPress vous alerte dès que votre site est hors ligne. Grâce à cette alerte, vous détectez une erreur d'extension MySQL en quelques minutes plutôt qu'en plusieurs heures. Minimiser les interruptions de service protège vos visiteurs, votre référencement et vos revenus.

• Documentez votre infrastructure serveur. Si vous gérez vous-même votre serveur, conservez une trace détaillée de toutes les extensions PHP et configurations utilisées. Cette documentation facilite grandement la réplication de l'environnement après des migrations ou des mises à jour majeures.

• Suivez une routine de maintenance WordPress régulière. Une maintenance structurée, incluant les mises à jour du noyau, des extensions et des thèmes, la vérification des versions PHP et l'optimisation de la base de données WordPress, prévient les dérives de configuration et détecte les problèmes de compatibilité avant qu'ils n'entraînent des erreurs sur votre site. Planifiez une vérification mensuelle de votre configuration PHP en complément de vos tâches de maintenance habituelles.

Réflexions finales

L'erreur « Votre installation PHP semble ne pas disposer de l'extension MySQL » est perturbante, mais résolvable. Dans la plupart des cas, le problème provient d'une extension MySQLi désactivée ou manquante dans votre configuration PHP ; il s'agit donc d'un problème d'extension de base de données PHP et non d'un problème WordPress.

Commencez par la solution la plus simple : vérifiez si MySQLi est activé dans votre panneau de contrôle d’hébergement et activez-le le cas échéant. Si le problème persiste, suivez les étapes suivantes : vérifiez votre version de PHP, modifiez le fichier php.ini en ajoutant l’extension mysqliet réinstallez PHP si nécessaire.

Lorsque les modifications au niveau du serveur dépassent vos compétences, votre fournisseur d'hébergement peut généralement les résoudre en quelques minutes.

Plus important encore, mettez en place les conditions adéquates pour éviter que cette erreur ne se reproduise. Maintenez PHP à jour, utilisez un hébergement WordPress géré et engagez-vous à effectuer une maintenance régulière. Un site WordPress bien entretenu évite la plupart de ces erreurs avant qu'elles n'affectent vos visiteurs et se rétablit rapidement le cas échéant.

FAQ concernant la résolution de l'erreur « Votre installation PHP semble ne pas contenir l'extension MySQL »