Comprendre le problème
Les identifiants de base de données WordPress sont les quatre valeurs DB_NAME, DB_USER, DB_PASSWORD et DB_HOST de wp-config.php. Si l'une d'elles est fausse, la connexion à MySQL échoue. Le problème survient surtout après une migration, un changement de mot de passe ou une modification du fichier.
La piste à vérifier
Récupérez les bons identifiants dans le panneau d'hébergement, corrigez les quatre constantes DB_ de wp-config.php, et testez-les sur phpMyAdmin avant de recharger le site.
Comment reconnaître ce bug
- Le site affiche « Erreur lors de la connexion à la base de données »
- Le problème est apparu après une migration, une restauration ou un changement de mot de passe
- La connexion échoue aussi avec les mêmes identifiants dans phpMyAdmin
- L'administration /wp-admin est elle aussi inaccessible
Qu’est-ce que ce bug ?
wp-config.php contient les coordonnées de connexion à la base de données. WordPress les utilise pour s'authentifier auprès du serveur MySQL à chaque chargement. Une seule valeur erronée — nom de base, utilisateur, mot de passe ou hôte — suffit à faire échouer l'authentification et à bloquer tout le site.
Pourquoi ce problème apparaît
Migration sans mise à jour
Le site a changé d'hébergeur mais wp-config.php conserve les anciens identifiants.
Mot de passe modifié
Le mot de passe de l'utilisateur MySQL a été changé sans report dans wp-config.php.
DB_HOST incorrect
L'hôte n'est pas « localhost » mais une adresse spécifique propre à l'hébergeur.
Erreur de saisie
Une faute de frappe, un espace parasite ou un caractère spécial mal échappé dans une constante.
Comment réparer ce bug
Conservez une sauvegarde des fichiers et de la base de données. Testez les changements en préproduction lorsque c’est possible. Si vous ne maîtrisez pas une étape, demandez de l’aide avant de l’appliquer.
Retrouver les bons identifiants
Dans le panneau d'hébergement, section bases de données, relevez le nom exact de la base, l'utilisateur et l'hôte.
Ouvrir wp-config.php
Via FTP ou le gestionnaire de fichiers, éditez wp-config.php à la racine du site.
Corriger les quatre constantes
Mettez à jour DB_NAME, DB_USER, DB_PASSWORD et DB_HOST en respectant exactement la casse et sans espace superflu.
Réinitialiser le mot de passe MySQL
Si le mot de passe est inconnu, redéfinissez-le dans le panneau d'hébergement puis reportez la nouvelle valeur dans wp-config.php.
Tester avec phpMyAdmin
Connectez-vous à phpMyAdmin avec ces identifiants : une connexion réussie confirme qu'ils sont corrects.
Comment éviter qu’il revienne
- Conservez les identifiants de base de données dans un gestionnaire de mots de passe
- Mettez à jour wp-config.php immédiatement après toute migration
- Éditez wp-config.php avec un éditeur de code, jamais un traitement de texte
- Conservez une copie de sauvegarde de wp-config.php avant toute modification
Questions fréquentes
Où trouver les identifiants de base de données de mon site ?
Ils figurent dans wp-config.php (valeurs actuelles) et dans le panneau d'hébergement, section bases de données MySQL (valeurs réelles). En cas de divergence, ce sont celles du panneau qui font foi.
Quelle valeur mettre dans DB_HOST ?
Souvent « localhost », mais de nombreux hébergeurs imposent une adresse dédiée (par exemple un nom d'hôte ou une IP avec port). La valeur exacte est précisée dans le panneau d'hébergement.
Pourquoi les identifiants deviennent incorrects après une migration ?
Chaque hébergement crée sa propre base avec son propre nom, son utilisateur et son hôte. wp-config.php garde les anciennes valeurs : il faut les remplacer par celles du nouvel hébergement.
Comment réinitialiser le mot de passe de la base de données ?
Dans le panneau d'hébergement, ouvrez la gestion des bases MySQL, modifiez le mot de passe de l'utilisateur, puis reportez immédiatement cette nouvelle valeur dans la constante DB_PASSWORD de wp-config.php.