Comment corriger l’erreur « Erreur d’établissement d’une connexion à la base de données » dans WordPress

« Erreur d’établissement de la connexion à la base de données » est une erreur vous indiquant que votre site WordPress ne peut pas se connecter à sa base de données. Cela peut sembler difficile à résoudre, mais heureusement, il n’y a que quelques problèmes à l’origine, et avec un peu d’investigation et de dépannage, vous pouvez facilement résoudre le problème.

Ce guide explique ce que signifie « Erreur lors de l’établissement d’une connexion à la base de données », en présente les causes les plus courantes et explique comment les corriger.

Que signifie « Erreur d’établissement de la connexion à la base de données » de WordPress ?

Avant d’examiner l’erreur, nous devons comprendre comment fonctionne WordPress. Comme la plupart des applications CMS (Système de gestion de contenu), il se compose de deux parties intégrantes – des fichiers et une base de données.

Les fichiers constituent la structure du site web et contiennent les fonctionnalités essentielles de WordPress, les médias, les thèmes et les plugins.

D’autre part, la base de données contient les paramètres personnalisés et le contenu unique du site web. Toutes les pages, les articles, le texte et la conception sont enregistrés comme des entrées dans les tableaux.

Les fichiers communiquent avec la base de données via diverses fonctions PHP et MySQL et extraient les données visualisées sur les pages web.

Par conséquent, lorsque votre site web ne parvient pas à se connecter à la base de données, il ne peut pas récupérer les données nécessaires pour afficher les pages. WordPress vous avertit du problème en affichant le message « Erreur d’établissement de la connexion à la base de données », comme le montre l’image ci-dessous.

Quelles sont les causes les plus fréquentes d’« Erreur lors de l’établissement d’une connexion à la base de données » ?

Il existe différents scénarios dans lesquels l’erreur apparaît. Les plus courantes sont les suivantes:

• Paramètres de base de données incorrects dans le fichier de configuration – Des informations d’identification de base de données incorrectes sont sans doute la raison la plus courante pour une connexion à une base de données interrompue. Si le nom de la base de données, le nom d’utilisateur, le mot de passe ou le nom d’hôte sont incorrects, le site web ne se connectera pas à la base de données et renverra « Erreur d’établissement de la connexion à la base de données ».
• Privilèges de l’utilisateur de la base de données insuffisants – Une autre raison pour laquelle l’erreur se produit est que l’utilisateur de la base de données n’a pas les privilèges suffisants, même si les informations d’identification sont correctes. L’utilisateur doit avoir la permission d’exécuter tous les types d’opérations MySQL sur la base de données.
• Tableaux de la base de données corrompus – WordPress est un système hautement dynamique, et chaque fois que vous apportez des modifications à votre site web, les tableaux de la base de données sont modifiés. L’ajout ou la suppression de modules externes et de thèmes crée de nouveaux tableaux ou supprime ceux qui existent déjà, de nouvelles pages ajoutent de nouvelles entrées, etc.
  Avec autant d’opérations MySQL effectuées, occasionnellement, les tables peuvent être corrompues, ce qui peut conduire à une autre variante de « Erreur d’établissement de la connexion à la base de données » – « Une ou plusieurs tables de base de données sont indisponibles ».
• URL de sites web incorrectes – En de rares occasions, l’erreur « Erreur d’établissement d’une connexion à la base de données » pouvait être causée par des URL de sites web incorrectes.
• Fichiers WordPress corrompus – Une autre raison pour laquelle vous voyez le message « Erreur d’établissement de la connexion à la base de données » est que les fichiers principaux de WordPress de votre site web sont corrompus. Cela peut provenir d’un programme malveillant, d’un échec de mise à jour ou d’un transfert de fichier incomplet lors d’un déplacement manuel de votre site.
• Le serveur de base de données est arrêté ou surchargé.

Résolution de l’erreur « Erreur d’établissement d’une connexion à la base de données »

À première vue, l’erreur semble assez intimidante et difficile à résoudre. Cependant, cela se résume généralement à quelques paramètres clés, qui peuvent être facilement vérifiés et corrigés.

Inspectez le fichier wp-config.php de votre site web WordPress

Les paramètres de la base de données sont stockés dans le fichier de configuration de chaque installation de WordPress. Il s’appelle wp-config.php et se trouve à la racine de votre site web.

Pour vérifier le fichier, connectez-vous dans les dossiers du site web via FTP ou le panel de votre hébergement. Si vous êtes un utilisateur de SiteGround, accédez à Site Tools> Site> Gestionnaire de fichiers .

Le dossier racine de chaque site web est le répertoire votredomaine.com/public_html . Dans notre exemple, le nom du site web est sg-testing.com, et le dossier est donc sg-testing.com/public_html .

Avant d’effectuer des modifications, il est préférable de conserver une copie de sauvegarde du fichier, juste au cas où. Pour ce faire, faites un clic droit sur le fichier, sélectionnez Copier, et renommez la version copiée en wp-config-backup.php .

Après avoir créé la copie de sauvegarde, sélectionnez le fichier wp-config.php , et choisissez Modifier.

Le nom, l’utilisateur, le mot de passe et l’hôte de la base de données sont définis dans les lignes de code suivantes:

 // ** Paramètres de la base de données - Vous pouvez obtenir ces informations auprès de votre hébergeur ** //

/** Le nom de la base de données pour WordPress */

define( 'DB_NAME', 'database_name_here' );

/** Nom d'utilisateur de la base de données */

define( 'DB_USER', 'username_here' );

/** Mot de passe de la base de données */

define( 'DB_PASSWORD', 'password_here' );

/** Nom d'hôte de la base de données */

define( 'DB_HOST', 'localhost' );

Les valeurs de chaque paramètre doivent correspondre à la base de données, à l’utilisateur et au mot de passe existants sur le serveur MySQL du site web. Après avoir appliqué les modifications, cliquez sur l’icône Enregistrer (disquette).

Définir le nom d’hôte correct de la base de données

Le serveur MySQL est défini par la ligne de code:

 define( 'DB_HOST', 'localhost' );

Typiquement, l’hôte de la base de données est sur le même serveur que les fichiers du site web. Par conséquent, la valeur est « localhost » ou « 127.0.0.1 » et la ligne entière indiquera:

 define( 'DB_HOST', 'localhost' );

ou

 define( 'DB_HOST', '127.0.0.1' );

Si vous avez défini un hôte de base de données distant, vous devez remplacer ces valeurs par le nom d’hôte correct du serveur distant.

Définir le nom correct de la base de données

Une fois l’hôte établi, vérifiez les détails de la base de données sur le serveur MySQL. Les utilisateurs de SiteGround peuvent facilement accéder aux paramètres de la base de données MySQL depuis Site Tools> Site> MySQL .

Pour comparer les paramètres du fichier wp-config.php avec les détails de la base de données MySQL , ouvrez la section MySQL dans un nouvel onglet de navigateur avec la droite- en cliquant dessus et en choisissant Ouvrir dans un nouvel onglet .

Les bases de données existantes sur le serveur MySQL sont listées dans l’onglet Bases de données sous Gérer les bases de données .

La base de données qui y est listée doit correspondre à celle définie dans le fichier wp-config.php .

Copier le nom de la base de données depuis MySQL> Databases et collez -le dans la ligne de code dans wp-config.php :

 define( 'DB_NAME', 'database_name_here' );

Définir le bon nom d’utilisateur pour la base de données

Pour voir l’utilisateur de la base de données, cliquez sur le lien sous la colonne Users de la base de données.

Une fenêtre popup apparaîtra listant tous les utilisateurs ayant les privilèges pour modifier la base de données du site web. Sélectionnez le nom d’utilisateur dans la colonne User et copiez-le.

Revenez à l’édition du fichier wp-config.php et collez le nom dans la ligne:

 define( 'DB_USER', 'username_here' );

S’il n’y a aucun utilisateur attaché à la base de données, il n’y aura aucun lien sous la colonne Users . Cliquez sur l’icône Ajouter un nouvel utilisateur dans la colonne Actions pour ajouter un utilisateur existant à la base de données du site.

Dans la fenêtre contextuelle, choisissez un des noms dans le menu déroulant Users , cochez le bouton radio All Privileges, et cliquez sur Confirmer.

Une fois que l’utilisateur est attaché à la base de données, vous pouvez copier son nom et le coller dans le fichier wp-config.php .

S’il n’y a aucun utilisateur existant, ouvrez la section Site Tools> Site> MySQL> Utilisateurs . Vous pouvez créer un nouvel utilisateur en cliquant sur le bouton Créer un utilisateur .

Le nouveau nom d’utilisateur apparaîtra dans la section Gérer les utilisateurs de l’onglet Utilisateurs . Cliquer sur l’icône Ajouter une nouvelle base de données pour attacher l’utilisateur à la base de données du site.

Dans la fenêtre contextuelle, sélectionnez la base de données du site web, cochez le bouton radio Tous les privilèges, et cliquez sur Confirmer .

Vous pouvez alors copier le nouveau nom d’utilisateur et le coller dans la ligne correspondante dans wp-config.php.

Définir le mot de passe correct de l’utilisateur de la base de données

Après avoir ajouté l’utilisateur dans wp-config.php , vous devez vous assurer que le mot de passe de l’utilisateur dans le fichier correspond à son équivalent dans MySQL . Copiez la chaîne de mot de passe de la ligne dans wp-config.php:

 define( 'DB_PASSWORD', 'password_here' );

Une fois le mot de passe copié, retournez dans Site> MySQL> Utilisateurs , appuyez sur le menu kebab, et sélectionnez Modifier le mot de passe.

Collez le mot de passe dans le champ Nouveau mot de passe et cliquez sur Confirmer.

L’erreur devrait disparaître lors du rechargement du site web si toutes les informations d’identification sont définies correctement.

Vérifier si l’utilisateur de la base de données dispose des privilèges appropriés

Pour vérifier les privilèges de l’utilisateur, accédez à Site Tools> Site> MySQL> Users , et recherchez l’utilisateur dans la section Gérer les utilisateurs. Cliquez sur le lien sous la colonne Accès à la base de données , une nouvelle fenêtre s’ouvre.

Cliquez sur l’icône Gérer l’accès pour ouvrir une nouvelle fenêtre dans laquelle les options d’accès sont gérées.

Pour définir toutes les permissions nécessaires, sélectionnez le bouton radio Tous les privilèges et cliquez sur le bouton Confirmer .

Réparer la base de données

Si votre base de données est endommagée, vous devez la réparer, et heureusement, WordPress dispose d’un mode de réparation intégré.

Pour l’activer, vous devez modifier le fichier wp-config.php de votre site web via FTP ou le panneau de contrôle de votre hébergement.

Les utilisateurs de SiteGround peuvent modifier le fichier en accédant à Site Tools> Site> Gestionnaire de fichiers . Le fichier est situé dans le répertoire racine du site web, qui est votredomaine.com/public_html (où vous devez remplacer votredomaine.com par votre propre domaine).

Sélectionnez wp-config.php et appuyez sur Édition .

Juste au-dessus de la ligne « /* C’est tout, arrêtez d’éditer ! Bonne publication. */” , ajoutez le code suivant:

 define('WP_ALLOW_REPAIR', true);

Confirmez les modifications en cliquant sur l’icône Enregistrer .

Pour charger le mode réparation, ouvrez la page https://yourdomain.com/wp-admin/maint/repair.php dans votre navigateur, où votredomaine.com est remplacé par le nom de votre site web. Par exemple, notre nom est sg-testing.com, donc l’adresse serait https://sg-testing.com/wp-admin/maint/repair.php .

Choisissez entre les deux options Réparer la base de données et Réparer et optimiser la base de données , et une fois la maintenance terminée, rechargez la page d’accueil de votre site web. Une fois que vous confirmez que l’erreur est corrigée, supprimez le code que vous avez ajouté dans wp-config.php afin que personne d’autre ne puisse lancer le mode réparation.

Inspecter l’URL du site WordPress dans la base de données

Cette erreur vous empêchera de vous connecter au tableau de bord où l’URL du site web est définie. Cependant, vous pouvez utiliser phpMyAdmin pour éditer les tables où ces paramètres sont définis.

Les utilisateurs de SiteGround peuvent accéder à l’outil en accédant à Site Tools> Site> MySQL> PHPMYADMIN > ACCÈS À PHPMYADMIN .

Cliquez sur la base de données du site web dans la colonne de gauche et ouvrez le tableau wp_options .

Les URL des sites web sont définies dans les options siteurl et home. Appuyez sur Edit sur chacun d’eux, définissez l’URL correcte du site web dans le champ option_value et confirmez le changement avec le bouton Aller .

Restaurer une sauvegarde du site

Si vous rencontrez l’erreur après un transfert manuel, assurez-vous d’ exporter une nouvelle sauvegarde complète du site web depuis l’hébergement précédent et de l’importer dans le nouvel hébergement à nouveau.

Si le site web n’a pas été transféré et que l’erreur apparaît soudainement, votre meilleur choix est de restaurer le site web à partir d’une sauvegarde récente. Consultez ce tutoriel pour l’outil de sauvegarde de SiteGround.

Contacter l’hébergeur

Les solutions décrites ci-dessus fonctionnent si le problème provient de la configuration du site web. Cependant, WordPress peut ne pas réussir à se connecter à la base de données si le serveur MySQL est surchargé ou en maintenance.

Si vous gérez votre propre serveur, pensez à redémarrer le service MySQL pour effacer toutes les requêtes bloquées sur la base de données.

Les utilisateurs disposant d’un hébergement géré n’ont pas ce type d’accès. Contactez l’équipe d’assistance de votre fournisseur afin qu’elle puisse vérifier l’état du serveur et résoudre les problèmes de son côté.

Résumé

« Erreur d’établissement d’une connexion à une base de données » est une erreur WordPress répandue que vous êtes susceptible de rencontrer de temps en temps. En un mot, il vous informe que votre site web ne peut pas se connecter avec sa base de données.

Pendant cette période, votre site web n’est pas accessible et vous devez le réparer avant de perdre un trafic substantiel. Mais ne vous inquiétez pas, il y a seulement un petit nombre de causes, et avec un peu de dépannage, elles peuvent être facilement aplanies.

Ce guide a décrit les causes les plus courantes de l’erreur. En suivant attentivement les instructions, vous êtes sûr de remettre votre site web en ligne en un rien de temps.