Comment résoudre l’erreur ‘Établir une connexion à la base de données’ sur WordPress ?

Pourquoi l’erreur de connexion à la base de données apparaît-elle ?

L’erreur ‘Établir une connexion à la base de données’ est l’une des pannes les plus redoutées sous WordPress. Elle signifie que votre site ne parvient pas à communiquer avec la base de données MySQL qui stocke vos articles, pages, réglages et commentaires. Sans cette connexion, WordPress ne peut pas fonctionner et affiche un message d’erreur à la place de votre contenu.

Les causes sont variées : un mot de passe incorrect, un serveur surchargé, un fichier de configuration corrompu, ou une base de données endommagée. Heureusement, dans la majorité des cas, vous pouvez résoudre ce problème vous-même en suivant une approche méthodique.

Comprendre le fichier wp-config.php

Le fichier wp-config.php est le cœur de la configuration de WordPress. Il contient les identifiants de connexion à la base de données : nom de la base, utilisateur, mot de passe et hôte. Une erreur dans ces informations provoque immédiatement l’erreur de connexion.

Vérifier les informations de connexion

Accédez à votre serveur via FTP ou le gestionnaire de fichiers de votre hébergement. Ouvrez le fichier wp-config.php à la racine de votre site. Recherchez les lignes suivantes :

define('DB_NAME', 'nom_de_votre_base');
define('DB_USER', 'utilisateur_de_la_base');
define('DB_PASSWORD', 'mot_de_passe');
define('DB_HOST', 'localhost');

Comparez ces valeurs avec celles fournies par votre hébergeur. Une erreur fréquente est de confondre le nom d’utilisateur de la base de données avec celui de votre compte d’hébergement. Assurez-vous que le mot de passe ne contient pas de caractères spéciaux qui pourraient être mal interprétés.

Réinitialiser le mot de passe de la base de données

Si vous avez un doute sur le mot de passe, connectez-vous à phpMyAdmin (ou l’outil équivalent fourni par votre hébergeur). Sous l’onglet ‘Utilisateurs’, vous pouvez modifier le mot de passe de l’utilisateur associé à votre base. Choisissez un mot de passe fort, sans symboles problématiques, puis mettez à jour le fichier wp-config.php avec ce nouveau mot de passe.

Réparer une base de données corrompue

Une base de données peut se corrompre suite à une coupure de courant, un plugin défectueux ou une manipulation hasardeuse. WordPress intègre une fonction de réparation automatique.

Activer la réparation automatique

Ajoutez la ligne suivante dans votre fichier wp-config.php, juste avant la ligne /* That's all, stop editing! */ :

define('WP_ALLOW_REPAIR', true);

Ensuite, rendez-vous sur https://votresite.com/wp-admin/maint/repair.php. Vous verrez deux options : ‘Réparer la base de données’ et ‘Réparer et optimiser la base de données’. Cliquez sur la première pour lancer la réparation. Une fois terminée, supprimez la ligne ajoutée dans wp-config.php pour des raisons de sécurité.

Utiliser phpMyAdmin pour réparer manuellement

Si la réparation automatique échoue, connectez-vous à phpMyAdmin. Sélectionnez votre base de données, cochez toutes les tables, puis dans le menu déroulant ‘Avec la sélection’, choisissez ‘Réparer la table’. Cette opération peut prendre quelques minutes.

Vérifier l’état du serveur MySQL

Parfois, le problème vient du serveur de base de données lui-même. Contactez votre hébergeur ou vérifiez le tableau de bord de votre hébergement pour savoir si MySQL est en cours d’exécution. Sur certains hébergements mutualisés, le service peut être redémarré depuis l’interface d’administration.

Redémarrer MySQL (si vous avez un accès serveur)

Si vous utilisez un VPS ou un serveur dédié, vous pouvez redémarrer MySQL via la ligne de commande :

sudo systemctl restart mysql

Ou pour MariaDB :

sudo systemctl restart mariadb

Vérifiez ensuite que le service est actif :

sudo systemctl status mysql

Désactiver les plugins et thèmes récents

Un plugin ou un thème mal codé peut altérer la connexion à la base de données. Si vous avez récemment installé ou mis à jour un plugin, essayez de le désactiver.

Désactiver via FTP

Accédez au dossier /wp-content/plugins/ via FTP. Renommez le dossier du plugin suspect (par exemple, mon-plugin en mon-plugin-desactive). Cela désactive le plugin sans passer par l’administration. Si l’erreur disparaît, le plugin est en cause.

De même, pour le thème, renommez le dossier du thème actif dans /wp-content/themes/. WordPress utilisera alors un thème par défaut.

Vérifier les permissions des fichiers

Des permissions incorrectes sur les fichiers WordPress peuvent empêcher la lecture du fichier wp-config.php ou l’accès à la base. Les permissions recommandées sont :

Utilisez votre client FTP pour ajuster les permissions. Certains hébergeurs imposent des permissions spécifiques, renseignez-vous auprès du support.

Contacter l’hébergement

Si aucune des solutions précédentes ne fonctionne, le problème peut provenir de l’hébergeur : base de données saturée, limite de connexions atteinte, ou maintenance serveur. Ouvrez un ticket de support en décrivant les étapes déjà effectuées. Fournissez des captures d’écran si possible.

Prévenir l’erreur à l’avenir

Voici quelques bonnes pratiques pour éviter de revivre ce cauchemar :

• Effectuez des sauvegardes régulières de votre base de données et de vos fichiers.
• Utilisez un plugin de cache et un CDN pour réduire la charge sur le serveur.
• Mettez à jour WordPress, les thèmes et les plugins dès que possible.
• Limitez le nombre de plugins actifs à l’essentiel.
• Surveillez les performances de votre site avec des outils comme Query Monitor.

FAQ – Questions fréquentes sur l’erreur de connexion à la base de données

Que faire si je ne peux pas accéder à phpMyAdmin ?

Contactez votre hébergeur. La plupart des hébergeurs proposent une alternative comme Adminer ou un accès via l’interface cPanel. Vous pouvez aussi utiliser un client MySQL comme MySQL Workbench si vous avez les accès distants.

L’erreur apparaît après avoir changé de mot de passe, pourquoi ?

Vous avez probablement oublié de mettre à jour le fichier wp-config.php avec le nouveau mot de passe. Vérifiez et corrigez.

Puis-je perdre mes données si je répare la base ?

Non, la réparation ne supprime pas de données. Elle corrige les incohérences dans les tables. Cependant, faites toujours une sauvegarde avant toute opération.

Comment savoir si le problème vient de l’hébergeur ?

Vérifiez le statut de votre hébergeur sur des sites comme Downdetector ou contactez le support. Si d’autres sites sur le même serveur rencontrent le même problème, l’hébergeur est probablement en cause.

Le message d’erreur est en anglais, est-ce normal ?

Oui, le message par défaut de WordPress est en anglais. Il peut être traduit si vous utilisez un fichier de traduction, mais l’erreur s’affiche souvent en anglais.

Puis-je restaurer une sauvegarde pour résoudre l’erreur ?

Oui, si vous avez une sauvegarde récente de la base de données et des fichiers, vous pouvez la restaurer. Cela remplacera les données actuelles, donc assurez-vous de ne pas perdre d’informations importantes.

Récapitulatif des actions à mener

Pour vous guider, voici une checklist à suivre dans l’ordre :

1. Vérifier les identifiants dans wp-config.php.
2. Réinitialiser le mot de passe de la base via phpMyAdmin.
3. Activer la réparation automatique de WordPress.
4. Réparer les tables avec phpMyAdmin.
5. Redémarrer MySQL (si possible).
6. Désactiver plugins et thèmes via FTP.
7. Vérifier les permissions des fichiers.
8. Contacter l’hébergement.

En suivant ces étapes, vous devriez pouvoir résoudre l’erreur ‘Établir une connexion à la base de données’ et retrouver un site WordPress fonctionnel. N’oubliez pas de sauvegarder régulièrement votre site pour minimiser les dégâts en cas de problème similaire.

Photo by Surprising_Media on Pixabay