« error establishing a database connection » est probablement l'une des erreurs les plus courantes et les plus effrayantes que les utilisateurs de WordPress peuvent rencontrer. Il est certainement étroitement lié à l'écran blanc de la mort (WSOD). Cette erreur signifie que votre site ne communique plus ou n'est plus accessible à la base de données WordPress et que tout le site est en panne.
Pour une telle erreur, les webmasters ne doivent jamais prendre les choses à la légère et doivent immédiatement essayer de résoudre ce problème qui affecte directement le trafic, le référencement, etc. Mais ne vous inquiétez pas, nous aborderons aujourd'hui quelques scénarios courants qui conduisent à cette erreur et les solutions correspondantes .
Qu'est-ce qu'une « error establishing a database connection » ?
Toutes les informations sur un site WordPress, telles que les données de publication, les données de page, les méta-informations, les paramètres de plug-in, les informations de connexion, etc., sont stockées dans une base de données MySQL. Les seules données qui ne sont pas stockées sont le contenu multimédia, tel que les images, et les fichiers thème/plugin/core, tels que index.php, wp-login.php, etc. Quand quelqu'un visite votre site, PHP exécute le code sur la page et interroge les informations de la base de données, qui sont ensuite affichées sur le navigateur du visiteur.
Si, pour une raison quelconque, cela ne fonctionne pas correctement, une erreur se produira lors de l'établissement de la connexion à la base de données, comme indiqué ci-dessous. La page entière devient vierge car la connexion ne fonctionne pas correctement et aucune donnée ne peut être récupérée pour rendre la page. Cela casse non seulement le front-end du site, mais rend également impossible l'accès au tableau de bord WordPress.
Cependant, les visiteurs peuvent ne pas voir immédiatement cette erreur sur le front-end. C'est parce que le cache du site est toujours accessible jusqu'à l'expiration du cache.
Scénarios courants entraînant une « error establishing a database connection »
Le problème le plus courant est les informations d'identification de connexion à la base de données incorrectes
Le site WordPress doit utiliser les informations de connexion liées à la base de données pour se connecter à sa base de données MySQL correspondante.
La base de données est corrompue.
Étant donné que les thèmes et les plugins peuvent être installés et désinstallés tellement, la suppression et l'installation constantes au fil des ans peuvent parfois entraîner une corruption de la base de données. Cela peut être dû à des tables manquantes ou corrompues individuellement, ou certaines informations peuvent avoir été accidentellement supprimées.
Il peut y avoir des fichiers corrompus dans l'installation de WordPress.
Problèmes de serveur de base de données
Il peut y avoir de nombreux problèmes du côté de l'hôte Web, tels que la surcharge de la base de données en raison de pics de trafic ou de ne pas répondre en raison d'un trop grand nombre de connexions simultanées. En fait, avec l'hébergement partagé, c'est assez courant, car de nombreux sites partagent les ressources d'un même hébergeur.
Comment corriger « error establishing a database connections »
Avant de commencer à résoudre l'erreur, il est recommandé d'effectuer d'abord une sauvegarde de votre base de données, car bon nombre des suggestions suivantes impliquent de manipuler les informations de votre base de données. Quel que soit votre niveau de compétence, vous devez toujours effectuer une sauvegarde avant d'essayer de modifier la base de données de votre site Web WordPress.
Vous pouvez utiliser un plugin de sauvegarde WordPress tel que VaultPress ou WP Time Capsule pour sauvegarder des fichiers et des bases de données.
Si vous êtes un utilisateur de cPanel, il est très facile de sauvegarder les fichiers et la base de données de votre site Web. Accédez au tableau de bord cPanel, recherchez « Sauvegarde » dans le menu, puis sauvegardez manuellement l'intégralité de la base de données et des fichiers du site Web.
Bien sûr, vous pouvez également effectuer une sauvegarde manuelle des fichiers de votre site Web en accédant au serveur via des outils tels que SFTP, et une sauvegarde manuelle de votre base de données MySQL via phpMyAdmin. Une fois la sauvegarde réussie, il est temps de commencer à résoudre le problème « error establishing a database connection ».
Vérifier les identifiants de connexion à la base de données
La première chose à faire est de vérifier que les informations de connexion à la base de données pour le fichier de configuration WordPress sont correctes. Il s'agit de loin de la cause la plus fréquente des erreurs « error establishing a database connection », en particulier après la migration d'un site vers un nouveau fournisseur d'hébergement. Les détails de connexion d'un site WordPress sont stockés dans le fichier wp-config.php, qui se trouve généralement dans le répertoire racine.
Il contient quatre informations importantes qui doivent être correctes pour que la connexion à la base de données soit réussie.
Nom de la base de données
// ** MySQL settings ** //
/** The name of the database for WordPress */
define('DB_NAME', 'xxxxxx');
Nom d'utilisateur de la base de données
/** MySQL database username */
define('DB_USER', 'xxxxxx');
Mot de passe de la base de données
/** MySQL database password */
define('DB_PASSWORD', 'xxxxxxxxx');
Nom d'hôte MySQL
/** MySQL hostname */
define('DB_HOST', 'localhost');
Pour accéder au fichier wp-config.php, vous pouvez vous connecter au site via SFTP et naviguer jusqu'au répertoire racine du site. Ou, si vous utilisez cPanel, vous pouvez accéder au tableau de bord cPanel et cliquer sur « Gestionnaire de fichiers », accédez au répertoire racine du site, puis cliquez avec le bouton droit pour modifier le fichier.
Ce qui suit est un exemple de ce à quoi ressemble le fichier wp-config.php.
Vérifiez les informations d'identification de la base de données dans le panneau cPanel
La première chose à vérifier est le nom de la base de données. Pour cela, vous devez vous rendre dans le panneau de configuration de cPanel et vous connecter à phpMyAdmin .
Trouvez le nom de la base de données correspondant à votre site web dans le menu de gauche. Ignorez la base de données « information_schema », car il s'agit de la base de données utilisée par l'hôte. Ensuite, comparez ce nom avec la valeur DB_NAME dans le fichier wp-config.php. S'ils correspondent, ce n'est pas un problème. S'ils ne correspondent pas, vous devez mettre à jour le fichier wp-config.php.
Vous pouvez également vérifier qu'il s'agit de la bonne base de données en vous assurant que la base de données contient l'URL de votre site. Cliquez simplement sur la base de données puis cliquez sur la table wp_options (pour des raisons de sécurité, ce nom peut être légèrement différent, par exemple wpxx_options). En haut du tableau, vous verrez les valeurs de l'URL et du nom du site. S'ils correspondent à votre site actuel, il s'agit de la base de données de votre site.
Si le nom de la base de données est correct, mais que vous obtenez toujours une erreur lors de l'établissement de la connexion à la base de données, vous devez également vérifier le nom d'utilisateur et le mot de passe. Pour ce faire, vous devez créer un nouveau fichier PHP dans le répertoire racine de votre site WordPress (nommez-le au hasard, par exemple checkdb.php) et entrez le code suivant, qui doit être remplacé par les valeurs de db_user et db_password en utilisant le valeurs du fichier wp-config.php.
<?php $test = mysqli_connect('localhost', 'db_user', 'db_password'); if (!$test) { die(‘MySQL Error: ‘ . mysqli_error()); } echo ‘Database connection is working properly!’; mysqli_close($testConnection); ?>
Visitez https://votredomaine.com/checkdb.php avec votre navigateur. Si vous recevez « Erreur MySQL : Accès refusé », votre nom d'utilisateur ou votre mot de passe est incorrect et vous devrez passer à l'étape suivante pour réinitialiser les informations d'identification.
Cependant, s'il affiche « La connexion à la base de données fonctionne correctement. », alors le nom d'utilisateur et le mot de passe de la base de données sont corrects. Assurez-vous de supprimer ce fichier lorsque vous avez terminé les tests.
Si vous êtes sûr que le nom d'utilisateur et le mot de passe de la base de données sont incorrects, vous devrez les réinitialiser. Dans le cPanel, cliquez sur « Base de données MySQL ».
Faites défiler vers le bas et créez un nouvel utilisateur MySQL. Essayez de sélectionner un nom d'utilisateur et un mot de passe uniques (vous pouvez utiliser l'outil de génération de mot de passe fourni pour générer un mot de passe fort) afin qu'il ne soit pas facilement deviné. Cliquez ensuite sur « Créer un utilisateur ». Vous pouvez également modifier le mot de passe de l'utilisateur actuel de la base de données sur cet écran.
Faites ensuite défiler vers le bas et ajoutez le nouvel utilisateur à la base de données. L'écran suivant vous demandera les privilèges que vous souhaitez attribuer, sélectionnez "Tous les privilèges"
Utilisez ensuite ces nouvelles informations d'identification et mettez à jour le fichier wp-config.php (mettez à jour les valeurs DB_USER et DB_PASSWORD). À ce stade, vous pouvez également vérifier que les informations d'identification de la base de données sont correctes à l'aide du fichier de test mentionné précédemment. Cependant, si cela ne résout pas le problème, il se peut que le nom d'hôte (DB_HOST) soit erroné. Certains hôtes utilisent des valeurs différentes, vous pouvez vous référer à une liste de valeurs d'hôte de base de données commune, ou consulter la documentation relative à l'hôte et contacter le fournisseur d'hébergement à fournir. Certaines personnes peuvent également utiliser 127.0.0.1 au lieu de localhost.
Conclusion
Comme vous pouvez le voir, il existe de nombreuses façons de résoudre le problème « Erreur lors de l'établissement d'une connexion à la base de données » dans WordPress. L'erreur la plus courante est que les informations d'identification de la base de données définies dans le fichier wp-config.php sont incorrectes, donc vérifier qu'elles sont correctes devrait être la première étape. Quelle que soit la cause du « error establishing a database connection », nous espérons que les étapes ci-dessus vous aideront à remettre votre site Web en marche. N'oubliez pas de toujours faire une sauvegarde de votre site pour le restaurer si nécessaire.
Comment réparer rapidement « error establishing a database connection» dans WordPress
« error establishing a database connection » est probablement l'une des erreurs les plus courantes et les plus effrayantes que les utilisateurs de WordPress peuvent rencontrer. Il est certainement étroitement lié à l'écran blanc de la mort (WSOD). Cette erreur signifie que votre site ne communique plus ou n'est plus accessible à la base de données WordPress et que tout le site est en panne.
Pour une telle erreur, les webmasters ne doivent jamais prendre les choses à la légère et doivent immédiatement essayer de résoudre ce problème qui affecte directement le trafic, le référencement, etc. Mais ne vous inquiétez pas, nous aborderons aujourd'hui quelques scénarios courants qui conduisent à cette erreur et les solutions correspondantes .
Qu'est-ce qu'une « error establishing a database connection » ?
Toutes les informations sur un site WordPress, telles que les données de publication, les données de page, les méta-informations, les paramètres de plug-in, les informations de connexion, etc., sont stockées dans une base de données MySQL. Les seules données qui ne sont pas stockées sont le contenu multimédia, tel que les images, et les fichiers thème/plugin/core, tels que index.php, wp-login.php, etc. Quand quelqu'un visite votre site, PHP exécute le code sur la page et interroge les informations de la base de données, qui sont ensuite affichées sur le navigateur du visiteur.
Si, pour une raison quelconque, cela ne fonctionne pas correctement, une erreur se produira lors de l'établissement de la connexion à la base de données, comme indiqué ci-dessous. La page entière devient vierge car la connexion ne fonctionne pas correctement et aucune donnée ne peut être récupérée pour rendre la page. Cela casse non seulement le front-end du site, mais rend également impossible l'accès au tableau de bord WordPress.
Cependant, les visiteurs peuvent ne pas voir immédiatement cette erreur sur le front-end. C'est parce que le cache du site est toujours accessible jusqu'à l'expiration du cache.
Scénarios courants entraînant une « error establishing a database connection »
Le problème le plus courant est les informations d'identification de connexion à la base de données incorrectes
Le site WordPress doit utiliser les informations de connexion liées à la base de données pour se connecter à sa base de données MySQL correspondante.
La base de données est corrompue.
Étant donné que les thèmes et les plugins peuvent être installés et désinstallés tellement, la suppression et l'installation constantes au fil des ans peuvent parfois entraîner une corruption de la base de données. Cela peut être dû à des tables manquantes ou corrompues individuellement, ou certaines informations peuvent avoir été accidentellement supprimées.
Il peut y avoir des fichiers corrompus dans l'installation de WordPress.
Problèmes de serveur de base de données
Il peut y avoir de nombreux problèmes du côté de l'hôte Web, tels que la surcharge de la base de données en raison de pics de trafic ou de ne pas répondre en raison d'un trop grand nombre de connexions simultanées. En fait, avec l'hébergement partagé, c'est assez courant, car de nombreux sites partagent les ressources d'un même hébergeur.
Comment corriger « error establishing a database connections »
Avant de commencer à résoudre l'erreur, il est recommandé d'effectuer d'abord une sauvegarde de votre base de données, car bon nombre des suggestions suivantes impliquent de manipuler les informations de votre base de données. Quel que soit votre niveau de compétence, vous devez toujours effectuer une sauvegarde avant d'essayer de modifier la base de données de votre site Web WordPress.
Vous pouvez utiliser un plugin de sauvegarde WordPress tel que VaultPress ou WP Time Capsule pour sauvegarder des fichiers et des bases de données.
Si vous êtes un utilisateur de cPanel, il est très facile de sauvegarder les fichiers et la base de données de votre site Web. Accédez au tableau de bord cPanel, recherchez « Sauvegarde » dans le menu, puis sauvegardez manuellement l'intégralité de la base de données et des fichiers du site Web.
Bien sûr, vous pouvez également effectuer une sauvegarde manuelle des fichiers de votre site Web en accédant au serveur via des outils tels que SFTP, et une sauvegarde manuelle de votre base de données MySQL via phpMyAdmin. Une fois la sauvegarde réussie, il est temps de commencer à résoudre le problème « error establishing a database connection ».
Vérifier les identifiants de connexion à la base de données
La première chose à faire est de vérifier que les informations de connexion à la base de données pour le fichier de configuration WordPress sont correctes. Il s'agit de loin de la cause la plus fréquente des erreurs « error establishing a database connection », en particulier après la migration d'un site vers un nouveau fournisseur d'hébergement. Les détails de connexion d'un site WordPress sont stockés dans le fichier wp-config.php, qui se trouve généralement dans le répertoire racine.
Il contient quatre informations importantes qui doivent être correctes pour que la connexion à la base de données soit réussie.
Nom de la base de données
Nom d'utilisateur de la base de données
Mot de passe de la base de données
Nom d'hôte MySQL
Pour accéder au fichier wp-config.php, vous pouvez vous connecter au site via SFTP et naviguer jusqu'au répertoire racine du site. Ou, si vous utilisez cPanel, vous pouvez accéder au tableau de bord cPanel et cliquer sur « Gestionnaire de fichiers », accédez au répertoire racine du site, puis cliquez avec le bouton droit pour modifier le fichier.
Ce qui suit est un exemple de ce à quoi ressemble le fichier wp-config.php.
Vérifiez les informations d'identification de la base de données dans le panneau cPanel
La première chose à vérifier est le nom de la base de données. Pour cela, vous devez vous rendre dans le panneau de configuration de cPanel et vous connecter à phpMyAdmin .
Trouvez le nom de la base de données correspondant à votre site web dans le menu de gauche. Ignorez la base de données « information_schema », car il s'agit de la base de données utilisée par l'hôte. Ensuite, comparez ce nom avec la valeur DB_NAME dans le fichier wp-config.php. S'ils correspondent, ce n'est pas un problème. S'ils ne correspondent pas, vous devez mettre à jour le fichier wp-config.php.
Vous pouvez également vérifier qu'il s'agit de la bonne base de données en vous assurant que la base de données contient l'URL de votre site. Cliquez simplement sur la base de données puis cliquez sur la table wp_options (pour des raisons de sécurité, ce nom peut être légèrement différent, par exemple wpxx_options). En haut du tableau, vous verrez les valeurs de l'URL et du nom du site. S'ils correspondent à votre site actuel, il s'agit de la base de données de votre site.
Si le nom de la base de données est correct, mais que vous obtenez toujours une erreur lors de l'établissement de la connexion à la base de données, vous devez également vérifier le nom d'utilisateur et le mot de passe. Pour ce faire, vous devez créer un nouveau fichier PHP dans le répertoire racine de votre site WordPress (nommez-le au hasard, par exemple checkdb.php) et entrez le code suivant, qui doit être remplacé par les valeurs de db_user et db_password en utilisant le valeurs du fichier wp-config.php.
<?php
$test = mysqli_connect('localhost', 'db_user', 'db_password');
if (!$test) {
die(‘MySQL Error: ‘ . mysqli_error());
}
echo ‘Database connection is working properly!’;
mysqli_close($testConnection);
?>
Visitez https://votredomaine.com/checkdb.php avec votre navigateur. Si vous recevez « Erreur MySQL : Accès refusé », votre nom d'utilisateur ou votre mot de passe est incorrect et vous devrez passer à l'étape suivante pour réinitialiser les informations d'identification.
Cependant, s'il affiche « La connexion à la base de données fonctionne correctement. », alors le nom d'utilisateur et le mot de passe de la base de données sont corrects. Assurez-vous de supprimer ce fichier lorsque vous avez terminé les tests.
Si vous êtes sûr que le nom d'utilisateur et le mot de passe de la base de données sont incorrects, vous devrez les réinitialiser. Dans le cPanel, cliquez sur « Base de données MySQL ».
Faites défiler vers le bas et créez un nouvel utilisateur MySQL. Essayez de sélectionner un nom d'utilisateur et un mot de passe uniques (vous pouvez utiliser l'outil de génération de mot de passe fourni pour générer un mot de passe fort) afin qu'il ne soit pas facilement deviné. Cliquez ensuite sur « Créer un utilisateur ». Vous pouvez également modifier le mot de passe de l'utilisateur actuel de la base de données sur cet écran.
Faites ensuite défiler vers le bas et ajoutez le nouvel utilisateur à la base de données. L'écran suivant vous demandera les privilèges que vous souhaitez attribuer, sélectionnez "Tous les privilèges"
Utilisez ensuite ces nouvelles informations d'identification et mettez à jour le fichier wp-config.php (mettez à jour les valeurs DB_USER et DB_PASSWORD). À ce stade, vous pouvez également vérifier que les informations d'identification de la base de données sont correctes à l'aide du fichier de test mentionné précédemment. Cependant, si cela ne résout pas le problème, il se peut que le nom d'hôte (DB_HOST) soit erroné. Certains hôtes utilisent des valeurs différentes, vous pouvez vous référer à une liste de valeurs d'hôte de base de données commune, ou consulter la documentation relative à l'hôte et contacter le fournisseur d'hébergement à fournir. Certaines personnes peuvent également utiliser 127.0.0.1 au lieu de localhost.
Conclusion
Comme vous pouvez le voir, il existe de nombreuses façons de résoudre le problème « Erreur lors de l'établissement d'une connexion à la base de données » dans WordPress. L'erreur la plus courante est que les informations d'identification de la base de données définies dans le fichier wp-config.php sont incorrectes, donc vérifier qu'elles sont correctes devrait être la première étape. Quelle que soit la cause du « error establishing a database connection », nous espérons que les étapes ci-dessus vous aideront à remettre votre site Web en marche. N'oubliez pas de toujours faire une sauvegarde de votre site pour le restaurer si nécessaire.
Articles Similaires:
Articles similaires