Table des matières:
Comprendre l’erreur ‘Your PHP installation appears to be missing the MySQL extension’
L’erreur ‘Your PHP installation appears to be missing the MySQL extension’ est un message frustrant que de nombreux utilisateurs de WordPress rencontrent. Elle indique que PHP ne peut pas communiquer avec la base de données MySQL, ce qui empêche votre site de fonctionner correctement. Cette erreur survient généralement lors de l’installation de WordPress, d’une mise à jour ou d’un changement de serveur.
Pourquoi cette erreur apparaît-elle ?
Plusieurs causes peuvent déclencher ce message :
- Extension MySQL manquante ou désactivée : PHP nécessite l’extension
mysqlioumysql(obsolète) pour se connecter à MySQL. Si elle n’est pas installée ou activée, l’erreur apparaît. - Version PHP incompatible : Certaines versions de PHP ne supportent plus l’ancienne extension mysql. Il faut utiliser
mysqliouPDO_MYSQL. - Fichier php.ini mal configuré : L’extension peut être présente mais commentée dans php.ini.
- Serveur obsolète : Un hébergement mutualisé peut utiliser une ancienne version de PHP sans extension MySQL.
- WordPress corrompu : Une mise à jour incomplète peut altérer les fichiers de connexion.
Solutions pour corriger l’erreur ‘Your PHP installation appears to be missing the MySQL extension’
1. Vérifier la version de PHP et l’extension MySQL
Avant toute modification, identifiez votre version de PHP et les extensions activées. Créez un fichier info.php avec le contenu suivant :
<?php phpinfo(); ?>
Hébergez-le à la racine de votre site et accédez-y via votre navigateur. Cherchez la section mysqli ou mysql. Si absente, l’extension n’est pas installée.
2. Activer l’extension MySQL dans php.ini
Si l’extension est présente mais désactivée, modifiez le fichier php.ini :
- Localisez la ligne
;extension=mysqliou;extension=mysql(selon votre version). - Supprimez le point-virgule au début pour l’activer.
- Redémarrez le serveur web (Apache, Nginx) pour appliquer les changements.
3. Basculer vers une version PHP plus récente
Si votre hébergement propose plusieurs versions de PHP, passez à PHP 7.4 ou 8.x, qui incluent nativement mysqli. Contactez votre hébergeur ou utilisez le panneau de contrôle (cPanel, Plesk) pour changer la version.
4. Réinstaller ou mettre à jour WordPress
Une corruption des fichiers peut causer l’erreur. Téléchargez une nouvelle copie de WordPress depuis le site officiel et remplacez les fichiers à l’exception de wp-config.php et du dossier wp-content. Cela réinitialise les fichiers de base sans perdre vos données.
5. Vérifier le fichier wp-config.php
Assurez-vous que les informations de connexion à la base de données sont correctes dans wp-config.php. Vérifiez les constantes DB_NAME, DB_USER, DB_PASSWORD, DB_HOST. Un mauvais nom d’utilisateur ou mot de passe peut générer cette erreur.
Solutions avancées pour les développeurs
6. Compiler PHP avec l’extension MySQL
Si vous gérez votre propre serveur, recompilez PHP avec les options --with-mysqli ou --with-pdo-mysql. Cela garantit que l’extension est intégrée.
7. Utiliser PDO à la place de MySQLi
WordPress utilise principalement MySQLi, mais si vous développez un plugin, vous pouvez opter pour PDO. Modifiez votre code pour utiliser PDO_MYSQL, mais cela nécessite des changements profonds.
8. Vérifier les logs du serveur
Consultez les logs d’erreur de PHP et du serveur web. Ils peuvent indiquer exactement pourquoi l’extension ne se charge pas. Recherchez des messages comme « PHP Fatal error: Call to undefined function mysqli_connect ».
Prévenir l’erreur à l’avenir
- Mettez à jour régulièrement : Gardez WordPress, les thèmes et les plugins à jour pour éviter les incompatibilités.
- Choisissez un hébergement fiable : Optez pour un hébergeur qui supporte les versions récentes de PHP et MySQL.
- Testez les mises à jour sur un site de staging : Avant de déployer une mise à jour majeure, testez-la dans un environnement de préproduction.
- Surveillez les extensions PHP : Utilisez un fichier
phpinfo()périodiquement pour vérifier que les extensions nécessaires sont actives.
Que faire si rien ne fonctionne ?
Si toutes les solutions échouent, contactez votre hébergeur. Il peut s’agir d’une limitation de votre offre d’hébergement. Parfois, l’hébergeur doit activer l’extension au niveau du serveur. Expliquez clairement l’erreur ‘Your PHP installation appears to be missing the MySQL extension’ et demandez une intervention.
En résumé
L’erreur ‘Your PHP installation appears to be missing the MySQL extension’ est courante mais facile à résoudre avec la bonne approche. Vérifiez d’abord votre version de PHP et l’extension MySQL, activez-la dans php.ini ou changez de version PHP. Si le problème persiste, examinez votre fichier wp-config.php et les logs serveur. En suivant ces étapes, vous pourrez restaurer rapidement votre site WordPress.
Photo by Internet Archive Book Images on Wikimedia Commons
