Comment corriger l’erreur lors de l’établissement de la connexion à la base de données dans WordPress

Le message « Erreur lors de l’établissement de la connexion à la base de données » dans WordPress signifie que votre site ne parvient pas à se connecter à sa base de données MySQL ou MariaDB. Les causes courantes comprennent des identifiants de base de données incorrects, un serveur de base de données indisponible ou des limites de ressources imposées par l’hébergement.

Commencez par vérifier la configuration de votre base de données dans wp-config.php. Si ces paramètres sont corrects, vous devrez examiner le serveur de base de données et vérifier sa disponibilité.

Ce guide explique comment identifier la cause du problème et rétablir votre site en toute sécurité.

Quelles sont les causes de l’erreur de connexion à la base de données dans WordPress ?

WordPress utilise une base de données pour stocker les articles, les pages, les réglages et les informations des utilisateurs. Lorsque la connexion échoue, WordPress ne peut pas récupérer les informations nécessaires au chargement de votre site.

Les causes les plus courantes sont les suivantes :

• Un nom de base de données, un nom d’utilisateur ou un mot de passe incorrect.
• Un nom d’hôte de base de données incorrect.
• Une interruption du service MySQL ou MariaDB.
• Des autorisations manquantes pour l’utilisateur de la base de données.
• Des limites de connexions à la base de données ou des ressources serveur insuffisantes.
• Des paramètres incorrects après une migration du site.

Avant de commencer le dépannage, sauvegardez si possible les fichiers et la base de données de votre site, en particulier avant de modifier la configuration ou de tenter une réparation.

1. Vérifiez vos identifiants de base de données dans wp-config.php

Des identifiants de base de données incorrects comptent parmi les raisons les plus courantes pour lesquelles WordPress ne parvient pas à se connecter à sa base de données.

Le fichier wp-config.php contient les informations que WordPress utilise pour établir cette connexion.

Comment trouver wp-config.php

1. Connectez-vous au panneau de contrôle de votre hébergement.
2. Ouvrez le gestionnaire de fichiers ou connectez-vous par SFTP.
3. Accédez au répertoire d’installation de WordPress, généralement public_html.
4. Repérez le fichier wp-config.php.
5. Téléchargez-en une copie de sauvegarde avant de le modifier.

Recherchez ces quatre paramètres :

define( 'DB_NAME', 'your_database_name' );
define( 'DB_USER', 'your_database_user' );
define( 'DB_PASSWORD', 'your_database_password' );
define( 'DB_HOST', 'localhost' );

Il s’agit d’exemples, et non de valeurs à copier dans votre configuration.

Comparez-les aux informations de la base de données figurant dans le panneau de contrôle de votre hébergement.

Si le nom d’utilisateur, le nom de la base de données ou le mot de passe est incorrect, modifiez le paramètre concerné.

N’oubliez pas que vos identifiants de base de données sont différents de vos identifiants de connexion à l’administration de WordPress.

2. Vérifiez l’hôte de votre base de données

Même avec des identifiants corrects, WordPress ne peut pas se connecter si le nom d’hôte de la base de données est incorrect.

De nombreux environnements d’hébergement utilisent :

define( 'DB_HOST', 'localhost' );

Cependant, certains fournisseurs utilisent un autre nom d’hôte, une adresse IP ou un port personnalisé.

Ne remplacez pas localhost par 127.0.0.1 au hasard. Selon la configuration du serveur, ces valeurs peuvent utiliser des méthodes de connexion différentes.

Vérifiez le nom d’hôte correct de la base de données dans le panneau de contrôle de votre hébergement ou auprès de votre fournisseur.

Si l’erreur lors de l’établissement de la connexion à la base de données est apparue immédiatement après la migration de votre site, il est particulièrement important de vérifier le nouveau nom d’hôte de la base de données.

3. Vérifiez que le serveur de base de données fonctionne

Si les identifiants et l’hôte de la base de données sont corrects, l’étape suivante consiste à vérifier le service de base de données.

Sur un hébergement mutualisé

Ouvrez le panneau de contrôle de votre hébergement et essayez d’accéder à la base de données par phpMyAdmin, si cet outil est disponible.

Si phpMyAdmin signale également des problèmes de connexion, contactez votre hébergeur pour qu’il vérifie le service de base de données.

Gardez à l’esprit que le bon fonctionnement de phpMyAdmin ne signifie pas nécessairement que l’utilisateur de base de données configuré dans WordPress dispose des autorisations requises.

Sur un VPS ou un serveur dédié

Si vous gérez votre propre serveur Linux, connectez-vous par SSH.

Pour vérifier MariaDB :

sudo systemctl status mariadb

Pour vérifier MySQL :

sudo systemctl status mysql

Les noms des services peuvent varier selon le système d’exploitation et l’installation.

Si le service de base de données est arrêté, examinez ses journaux et les ressources disponibles avant de le redémarrer.

L’arrêt d’un service de base de données peut empêcher tous les sites qui dépendent de cette base de données de s’y connecter.

4. Vérifiez les autorisations de l’utilisateur de la base de données

WordPress a besoin d’un utilisateur de base de données disposant des autorisations suffisantes pour accéder à la base de données configurée.

Si vous avez migré un site ou restauré une sauvegarde, il est possible que l’utilisateur de la base de données ne soit pas associé à la bonne base de données.

Dans cPanel, ouvrez la section de gestion des bases de données et vérifiez que :

• La base de données existe.
• L’utilisateur de base de données configuré existe.
• L’utilisateur est associé à la bonne base de données.
• Le compte dispose des privilèges requis par WordPress.

Évitez de modifier les autorisations sans savoir ce que vous faites. Si vous avez un doute, demandez de l’aide à votre hébergeur.

5. Recherchez une éventuelle corruption de la base de données

La corruption de la base de données est moins fréquente que les identifiants incorrects ou les problèmes de disponibilité du serveur.

Toutefois, si WordPress signale des tables endommagées ou indique expressément qu’une réparation de la base de données est nécessaire, vous devrez peut-être approfondir vos recherches.

WordPress intègre une fonction de réparation de la base de données.

Commencez par créer une sauvegarde fiable. Ajoutez ensuite temporairement cette ligne dans wp-config.php :

define( 'WP_ALLOW_REPAIR', true );

Accédez à :

https://yourdomain.com/wp-admin/maint/repair.php

Suivez les instructions de réparation proposées.

Important : lorsque la fonction de réparation est activée, cette page ne nécessite pas de session WordPress authentifiée. Supprimez la ligne WP_ALLOW_REPAIR immédiatement après la réparation.

La réparation de la base de données ne corrigera ni des identifiants incorrects, ni l’indisponibilité du serveur de base de données, ni toutes les formes de corruption. N’utilisez cette fonction que lorsque cela est approprié.

6. Vérifiez les ressources du serveur et les limites de la base de données

L’erreur apparaît-elle pendant les périodes de forte activité, puis disparaît-elle lorsque vous actualisez la page ?

Cela peut indiquer une limite du nombre de connexions à la base de données, un épuisement des ressources ou des problèmes temporaires du serveur.

Demandez à votre hébergeur d’examiner :

• L’utilisation du processeur et de la mémoire.
• Les limites du nombre de connexions à la base de données.
• L’espace disque disponible.
• Les plantages ou redémarrages du service de base de données.
• Les journaux d’erreurs PHP et de la base de données pertinents.

Sur un serveur que vous gérez vous-même, examinez directement ces mêmes éléments.

Ne supposez pas qu’une mise à niveau de votre offre d’hébergement résoudra le problème. Identifiez d’abord sa cause réelle.

Si l’erreur lors de l’établissement de la connexion à la base de données se produit par intermittence, notez à quel moment elle survient et si elle coïncide avec un trafic élevé ou des tâches planifiées.

7. Examinez les modifications récentes de WordPress ou de l’hébergement

Si votre site a récemment cessé de fonctionner, vérifiez ce qui a changé juste avant l’apparition du problème.

Migration du site : vérifiez que la base de données a été importée et que wp-config.php contient les nouveaux identifiants et le nouveau nom d’hôte.

Changements de mot de passe : assurez-vous que WordPress utilise le mot de passe actuel de la base de données.

Modifications de l’hébergement : vérifiez que le service de base de données, le nom d’hôte et les autorisations de l’utilisateur sont correctement configurés.

Modifications des extensions ou des applications : vérifiez si un nombre excessif de requêtes ou de connexions à la base de données nuit à sa disponibilité.

Que faire si l’erreur persiste ?

Si aucune des étapes précédentes ne résout le problème, contactez votre hébergeur.

Indiquez approximativement quand le problème a commencé, s’il se produit en permanence ou par intermittence, ainsi que toute modification récente apportée à votre site.

Précisez les étapes de dépannage que vous avez déjà effectuées. N’envoyez jamais de mots de passe de base de données dans des messages d’assistance ordinaires.

Comment prévenir les futurs problèmes de connexion à la base de données

Toutes les interruptions de service ne peuvent pas être évitées, mais une bonne maintenance peut réduire les pannes évitables.

• Effectuez régulièrement des sauvegardes de votre site et de sa base de données.
• Maintenez WordPress, les thèmes et les extensions à jour.
• Surveillez les connexions à la base de données et l’utilisation des ressources.
• Conservez suffisamment d’espace de stockage sur le serveur.
• Testez les migrations de sites avant de rediriger le trafic de production.
• Protégez les identifiants de la base de données.
• Surveillez l’état du service de base de données sur les serveurs que vous gérez vous-même.

Ces mesures contribuent à réduire le risque de problèmes inattendus de disponibilité de la base de données.

Questions fréquentes

Conclusion

Pour corriger l’erreur lors de l’établissement de la connexion à la base de données dans WordPress, commencez par vérifier vos identifiants de base de données, le nom d’hôte et la disponibilité du serveur.

Si ces paramètres sont corrects, examinez les autorisations de la base de données, les limites de ressources et les modifications récentes de la configuration avant de tenter une réparation.

Effectuez ces vérifications méthodiquement et contactez votre hébergeur si le service de base de données ou l’infrastructure du serveur nécessite un examen plus approfondi.