Mise à jour: 12 septembre 2024
L’erreur d’établissement d’une connexion à la base de données (en anglais: « Error Establishing a Database Connection ») dans WordPress signifie que votre site ne peut pas se connecter à sa base de données. Cette situation rend votre site totalement inaccessible, affectant l’affichage public et l’accès à l’administration.
Elle peut être causée par des informations de connexion incorrectes, des problèmes de serveur, des fichiers corrompus ou des dépassements de ressources. Heureusement, cette erreur est réparable. Ce guide vous présente des solutions efficaces pour rétablir la connexion à la base de données et remettre rapidement votre site en ligne.
Causes courantes de l’erreur
L’erreur d’établissement d’une connexion à une base de données peut être déclenchée par plusieurs raisons. Comprendre ces causes vous aidera à cibler et à résoudre le problème rapidement.
1. Informations de connexion incorrectes
Les informations de connexion à la base de données, telles que le nom de la base de données, le nom d’utilisateur, le mot de passe ou l’hôte MySQL, peuvent être incorrectes. Ces informations sont stockées dans le fichier wp-config.php de votre installation WordPress.
2. Problèmes avec le serveur de base de données
Le serveur de base de données peut temporairement être hors ligne ou rencontrer des problèmes techniques. Cela peut se produire en raison de la surcharge du serveur ou d’un problème avec votre hébergeur.
3. Fichiers corrompus
Les fichiers de base de votre installation WordPress peuvent être corrompus. Cela peut se produire lors d’une mise à jour de WordPress, d’un plugin ou d’un thème ou à la suite d’une attaque malveillante.
4. Dépassement de la limite de ressources
Si votre site dépasse les limites de ressources allouées par votre hébergeur Web, cela peut entraîner cette erreur. Cela inclut la limite de mémoire PHP, le nombre maximum de connexions simultanées à la base de données, etc.
1. Vérification des informations de connexion
Les informations de connexion incorrectes dans le fichier wp-config.php sont l’une des causes les plus courantes de l’erreur « Error Establishing a Database Connection ». Voici comment vérifier et corriger ces informations.
Étape 1 : Accéder au fichier wp-config.php
- Accédez à votre serveur via FTP ou le gestionnaire de fichiers de votre hébergeur : Utilisez un client FTP comme FileZilla ou le gestionnaire de fichiers disponible dans votre cPanel.
- Naviguez jusqu’au fichier wp-config.php : Le fichier wp-config.php se trouve à la racine de votre installation WordPress.
- Assurez-vous de créer une sauvegarde de ce fichier. Après l’avoir sélectionné, cliquez sur « Copier » en haut à gauche. Renommez la version copiée en wp-config-01.php. Laisser une copie sur votre serveur et télécharger une autre sur votre ordinateur en cliquant sur le bouton « Télcéharger ».
Étape 2 : Vérifier les informations de connexion
- Ouvrez le fichier wp-config.php : Utilisez un éditeur de texte comme Notepad++ ou l’éditeur intégré de votre gestionnaire de fichiers pour ouvrir le fichier (cliquez sur le bouton « Modifier »).
- Vérifiez les constantes de connexion à la base de données :
define('DB_NAME', 'nom_de_votre_base_de_donnees');
define('DB_USER', 'nom_utilisateur_de_votre_base_de_donnees');
define('DB_PASSWORD', 'mot_de_passe_de_votre_base_de_donnees');
define('DB_HOST', 'localhost'); // Parfois c'est une adresse IP ou un autre domaine
Étape 3 : Corriger les informations de connexion
- Corrigez les informations incorrectes : Si vous trouvez une erreur dans les valeurs de DB_NAME, DB_USER, DB_PASSWORD, ou DB_HOST, corrigez-les et enregistrez le fichier wp-config.php.
- Enregistrez et téléchargez le fichier : Enregistrez les modifications et téléchargez le fichier modifié sur votre serveur si vous utilisez un client FTP.
- Accédez à votre site Web : Ouvrez votre navigateur et accédez à votre site WordPress pour voir si l’erreur est résolue.
2. Réparation de la base de données WordPress
Si vérifier les informations de connexion n’a pas résolu l’erreur d’établissement d’une connexion à une base de données, il est possible que la base de données soit corrompue. WordPress offre une fonction intégrée pour réparer et optimiser la base de données.
Étape 1 : Activer la fonction de réparation
- Accéder au fichier wp-config.php : Connectez-vous à votre serveur via FTP ou le gestionnaire de fichiers de votre hébergeur et ouvrez le fichier wp-config.php.
- Ajouter la ligne de code suivante : Ajoutez la ligne suivante n’importe où dans le fichier wp-config.php, de préférence après les autres constantes définies :
define('WP_ALLOW_REPAIR', true);
Enregistrez les modifications et téléchargez le fichier modifié sur votre serveur.
Étape 2 : Accéder à l’outil de réparation
- Ouvrir l’URL de réparation dans votre navigateur : Accédez à l’URL suivante dans votre navigateur : https://votre-site-web.com/wp-admin/maint/repair.php. Remplacez votre-site-web.com par le nom de domaine de votre site.
- Exécuter la réparation : Vous verrez deux options : « Réparer la base de données » et « Réparer et optimiser la base de données ». Cliquez sur l’option qui vous convient le mieux. La réparation seule est suffisante pour corriger les problèmes courants.
- Attendre la fin de la réparation : Laissez l’outil exécuter la réparation. Une fois terminé, vous verrez un message indiquant si la réparation a réussi ou si des erreurs persistent.
Étape 3 : Désactiver la fonction de réparation
- Retourner au fichier wp-config.php : Ouvrez à nouveau le fichier wp-config.php et supprimez la ligne que vous avez ajoutée : define(‘WP_ALLOW_REPAIR’, true);
- Enregistrer et télécharger le fichier : Enregistrez les modifications et téléchargez le fichier mis à jour sur votre serveur.
- Vérifier le site: Ouvrez votre navigateur et accédez à votre site WordPress pour vérifier si l’erreur est résolue.
3. Vérification du serveur de base de données
Si les vérifications et les réparations précédentes n’ont pas résolu l’erreur d’établissement d’une connexion à une base de données, il est possible que le problème provienne du serveur de base de données lui-même. Voici les étapes pour vérifier et résoudre les problèmes liés au serveur de base de données.
Étape 1 : Vérifier si le serveur de base de données est en ligne
- Accéder à votre tableau de bord d’hébergement : Connectez-vous au panneau de contrôle de votre hébergeur (cPanel, Plesk, etc.).
- Vérifier l’état du serveur MySQL : Dans le panneau de contrôle, recherchez la section liée aux services ou à l’état du serveur. Assurez-vous que le service MySQL est en cours d’exécution. S’il est arrêté, essayez de le redémarrer.
- Utiliser des outils de diagnostic fournis par votre hébergeur : Certains hébergeurs fournissent des outils de diagnostic pour vérifier l’état de la base de données et identifier les problèmes potentiels. Utilisez ces outils pour obtenir plus d’informations sur l’état de votre serveur de base de données.
Étape 2 : Tester la connexion à la base de données
- Créer un fichier de test PHP : Utilisez un éditeur de texte pour créer un fichier nommé test-db-connection.php. Ajoutez le code suivant et spécifiez les paramètres de connexion à votre base de données.
<?php
$link = mysqli_connect('localhost', 'nom_utilisateur', 'mot_de_passe', 'nom_de_la_base_de_donnees');
if (!$link) {
die('Erreur de connexion (' . mysqli_connect_errno() . ') ' . mysqli_connect_error());
}
echo 'Connexion réussie';
mysqli_close($link);
?>
- Télécharger le fichier sur votre serveur : Téléchargez ce fichier à la racine de votre installation WordPress en utilisant un client FTP ou le gestionnaire de fichiers de votre hébergeur.
- Exécuter le fichier de test : Accédez à https://votre-site-web.com/test-db-connection.php dans votre navigateur.
Si vous voyez le message « Connexion réussie », cela signifie que les informations de connexion sont correctes et que le serveur de base de données est en ligne. Si vous voyez une erreur, cela indique un problème avec les informations de connexion ou le serveur de base de données.
Étape 3 : Contact avec l’hébergeur
- Ouvrir un ticket de support : Si vous avez vérifié les informations de connexion et que le serveur de base de données semble être en ligne, mais que l’erreur persiste, ouvrez un ticket de support auprès de votre hébergeur. Fournissez-leur toutes les informations pertinentes, y compris les étapes que vous avez suivies pour résoudre le problème.
- Demander des détails sur les limitations de ressources : Demandez à votre hébergeur s’il y a des limitations de ressources (comme les connexions simultanées ou la mémoire allouée) qui pourraient affecter votre base de données.
4. Réparation des fichiers WordPress corrompus
Si la vérification du serveur de base de données n’a pas résolu l’erreur d’établissement d’une connexion à une base de données, il est possible que certains fichiers de base de WordPress soient corrompus. Réparer ces fichiers peut aider à résoudre le problème.
Étape 1 : Télécharger une nouvelle copie de WordPress
- Télécharger WordPress : Accédez au site officiel de WordPress (wordpress.org) et téléchargez la dernière version de WordPress.
- Extraire les fichiers : Une fois le fichier ZIP téléchargé, extrayez-le sur votre ordinateur pour obtenir les fichiers de base de WordPress.
Étape 2 : Remplacer les fichiers corrompus
- Connectez-vous à votre serveur via FTP : Utilisez un client FTP comme FileZilla pour vous connecter à votre serveur d’hébergement.
- Naviguez vers le répertoire de votre site WordPress : Accédez au répertoire où votre site WordPress est installé. Cela inclut généralement les dossiers wp-admin, wp-includes et wp-content.
- Téléchargez les nouveaux fichiers : Depuis les fichiers extraits, téléchargez les dossiers wp-admin et wp-includes vers votre serveur, en remplaçant les dossiers existants. Faites attention à ne pas remplacer le dossier wp-content pour ne pas perdre vos thèmes, plugins et médias.
Étape 3 : Vérifier les permissions des fichiers
Assurez-vous que les permissions des fichiers et des dossiers sont correctes. Les fichiers devraient généralement avoir des permissions de 644 et les dossiers de 755. Vous pouvez ajuster ces permissions via votre client FTP.
Enfin, ouvrez votre navigateur et accédez à votre site WordPress pour vérifier si l’erreur est résolue.
5. Augmentation des limites de ressources
Si les étapes précédentes n’ont pas résolu l’erreur « Error Establishing a Database Connection », il se peut que votre site dépasse les limites de ressources allouées par votre hébergeur. Voici comment augmenter ces limites pour résoudre le problème.
Étape 1 : Augmentez la limite de mémoire PHP
- Modifier le fichier wp-config.php
Connectez-vous à votre serveur via FTP ou utilisez le gestionnaire de fichiers de votre hébergeur. Ouvrez le fichier wp-config.php situé à la racine de votre installation WordPress. Ajoutez ou modifiez la ligne suivante pour augmenter la limite de mémoire PHP :
define('WP_MEMORY_LIMIT', '256M');
Enregistrez les modifications et téléchargez le fichier modifié sur votre serveur.
- Modifier le fichier .htaccess :
Accédez au fichier .htaccess situé à la racine de votre installation WordPress. Ajoutez la ligne suivante pour augmenter la limite de mémoire PHP :
php_value memory_limit 256M
Enregistrez les modifications et téléchargez le fichier modifié sur votre serveur.
Étape 2 : Augmenter les limites de connexion MySQL
- Modifier le fichier my.cnf :
Si vous avez accès à la configuration de votre serveur MySQL, vous pouvez augmenter les limites de connexion en modifiant le fichier my.cnf (ou my.ini sur certains systèmes). Ajoutez ou modifiez les lignes suivantes pour augmenter les limites de connexion :
max_connections = 500 wait_timeout = 600
Enregistrez les modifications et redémarrez le serveur MySQL pour appliquer les nouvelles configurations.
Étape 3 : Contacter votre hébergeur
Si vous ne pouvez pas modifier les paramètres vous-même, contactez le support technique de votre hébergeur.
Demandez une augmentation de la limite de mémoire PHP et des limites de connexion MySQL. Fournissez les détails de l’erreur et les étapes que vous avez déjà suivies pour aider l’équipe de support à comprendre le problème.
6. Autres solutions possibles
Si les méthodes précédentes n’ont pas résolu l’erreur « Erreur d’établissement de la connexion à la base de données », voici d’autres solutions à explorer pour diagnostiquer et corriger le problème.
Désactivation des plugins et des thèmes
- Désactiver les plugins via FTP ou le gestionnaire de fichiers de cPanel :
- Connectez-vous à votre serveur via FTP ou le gestionnaire de fichiers et accédez au répertoire /wp-content/plugins/.
- Renommez le dossier plugins en plugins_old. Cela désactivera tous les plugins sans les supprimer.
- Essayez d’accéder à votre site pour voir si l’erreur est résolue.
Il est aussi possible de désactiver tous les plugins à partir de la base de données.
- Désactiver le thème actif :
- Toujours via FTP, accédez au répertoire /wp-content/themes/.
- Renommez le dossier du thème actif en theme_old.
- Sample Item #3
WordPress utilisera automatiquement un thème par défaut comme Twenty Twenty-four. Vérifiez si l’erreur persiste.
Vérification des permissions des fichiers
Utilisez un client FTP pour vérifier les permissions de vos fichiers et dossiers. Les fichiers devraient généralement avoir des permissions de 644 et les dossiers de 755. Si nécessaire, ajustez les permissions via votre client FTP.
Utilisation des sauvegardes pour restaurer le site
Si vous avez une sauvegarde récente de votre site, utilisez-la pour restaurer votre site à un état antérieur avant que l’erreur ne se produise.
La plupart des hébergeurs offrent des outils de sauvegarde et de restauration dans leur panneau de contrôle.
Vérification des logs du serveur
Accédez aux fichiers de log de votre serveur (généralement accessibles via le cPanel ou un autre panneau de contrôle). Recherchez des messages d’erreur ou des anomalies qui pourraient indiquer la cause de l’erreur de connexion à la base de données.
Vérification de la version de PHP
Vérifiez la version de PHP utilisée par votre serveur. WordPress et certains plugins nécessitent des versions spécifiques de PHP pour fonctionner correctement. Mettez à jour PHP à une version compatible si nécessaire.
- Avis Chemicloud - 7 novembre 2024
- Meilleurs Plugins Cache WordPress - 21 octobre 2024
- Avis Gandi - 18 octobre 2024