Si vous avez créé un environnement local pour développer et tester votre site WordPress avec MAMP, il se peut qu’à un moment donné, vous receviez un message « Error establishing a database connection ». Avoir cette notification peut être déroutant, mais la solution est assez simple lorsque vous savez où regarder.

Dans cet article, nous allons expliquer ce qu’est cette erreur et pourquoi elle se produit. Nous vous expliquerons ensuite comment l’identifier et la corriger pour rétablir la connexion entre votre site WordPress et la base de données.

Que signifie l’erreur « Error Establishing a Database Connection » de MAMP

WordPress est un système de gestion de contenu (CMS) robuste qui vous permet de créer des pages web dynamiques au-delà d’un simple site HTML statique. WordPress stocke le contenu du site dans une base de données que le code de la page appelle en cas de besoin. En tant que tel, la communication entre les fichiers du site et la base de données est cruciale.

MAMP est un outil gratuit que vous pouvez télécharger (une option premium est disponible) pour exécuter votre site web sur votre ordinateur local au lieu d’un serveur web. Son nom est un acronyme de ce qu’il comprend – macOS, Apache, MySQL et PHP pour exécuter WordPress – plus d’autres outils facultatifs. L’installation de WordPress en local vous permet de tester le site pendant son développement.

Lorsqu’une erreur se produit en essayant d’établir une connexion à la base de données avec MAMP, c’est généralement parce que le fichier wp-config.php a des informations d’identification de base de données incorrectes. Plus précisément, l’erreur de connexion à la base de données dans MAMP indique une variable incorrecte ou une non-correspondance entre le fichier wp-config.php et la base de données. Plusieurs réglages incorrects peuvent être à l’origine de ce problème. Définissons chacun d’entre eux.

Causes courantes de l’erreur « Error Establishing a Database Connection » dans MAMP

Les principaux réglages du fichier wp-config.php qui permettent de connecter votre site WordPress à la base de données sont, par défaut :

  • Nom de la base de données : « wordpress » (sauf si vous l’avez renommé pendant l’installation)
  • Utilisateur de la base de données : « root »
  • Mot de passe de la base de données : « root »
  • Hôte de la base de données : « localhost »

Un port de serveur mal configuré peut également provoquer une erreur de connexion. Gardez cela à l’esprit, au cas où vos premiers efforts ne permettraient pas de résoudre l’erreur. Il se peut que vous deviez procéder à un dépannage supplémentaire des ports de votre serveur.

Important

Vous recherchez un outil de développement WordPress local, gratuit et puissant ? DevKinsta propose une création de site rapide et facile, des outils de gestion des e-mails et des bases de données, un changement de version PHP en un clic, et une intégration complète avec MyKinsta. Commencez avec DevKinsta dès aujourd’hui, même si vous n’êtes pas client de Kinsta.

Comment réparer l’erreur « Error Establishing a Database Connection » de MAMP (en 3 étapes)

Alors, que faire si vous rencontrez cette erreur ? Vous pouvez utiliser les étapes suivantes pour localiser, vérifier et corriger (si nécessaire) les réglages de configuration afin de rétablir la connexion entre WordPress et la base de données dans MAMP.

Étape 1 : Trouvez les informations d’identification de votre base de données

Il se peut que vous receviez un message d’erreur parce que les réglages de votre fichier wp-config.php sont incorrects. Ce fichier est le premier endroit que vous devez vérifier, car il est souvent à l’origine de l’erreur. Il s’agit également d’une correction simple qui peut rapidement résoudre le problème.

Vous pouvez localiser le fichier wp-config.php dans le répertoire principal de votre site WordPress. Pour les utilisateurs Windows, l’emplacement par défaut du fichier se trouve dans le répertoire C:/MAMP/htdocs/wordpress/ de votre ordinateur. Pour les utilisateurs Mac, il se trouve dans le répertoire /Applications/MAMP/htdocs/wordpress/.

Vous pouvez vérifier l’emplacement de votre installation WordPress MAMP en contrôlant ses réglages. Pour cela, ouvrez l’application MAMP :

L'application MAMP

L’application MAMP

Votre répertoire d’installation est listé dans les réglages Document Root.

Étape 2 : Vérifiez vos identifiants de connexion à la base de données

Une fois que vous avez localisé le fichier wp-config.php dans votre installation WordPress locale, ouvrez-le. Ensuite, faites défiler vers le bas jusqu’à ce que vous trouviez les informations d’identification de la base de données :

 Les informations de la base de données de WordPress figurant dans le fichier wp-config.php.

Les informations de la base de données de WordPress figurant dans le fichier wp-config.php.

Il y aura un groupe de définitions pour :

  • ‘DB_NAME’
  • ‘DB_USER’
  • ‘DB_PASSWORD’
  • ‘DB_HOST’

Vérifiez que la valeur « DB_NAME » correspond au nom de votre base de données. Il peut s’agir de « wordpress » par défaut, comme le montre l’image ci-dessus.

Notez que si vous avez changé le nom « wordpress » par défaut et que vous ne vous rappelez pas comment vous avez renommé la base de données, il existe un autre chemin que vous pouvez prendre. Dans MAMP, sélectionnez Ouvrir la page de démarrage (Windows) ou WebStart (Mac). Lorsque le navigateur s’ouvre sur la page de démarrage de MAMP, accédez à phpMyAdmin dans le menu Outils :

Le menu de démarrage de l'application MAMP

Le menu de démarrage de l’application MAMP

Une liste de bases de données apparaîtra dans la colonne de gauche de phpMyAdmin. Localisez le nom de votre base de données WordPress (affiché par défaut comme « wordpress » dans l’image ci-dessous) :

L'écran des réglages de phpMyAdmin

L’écran des réglages de phpMyAdmin

Une fois que vous avez vérifié (ou corrigé) le nom de la base de données, vous pouvez descendre dans la liste des définitions du fichier wp-config.php pour vérifier que les autres réglages de la base de données sont corrects. Si vous avez modifié votre identifiant ou votre mot de passe, vous pouvez le corriger directement dans votre fichier wp-config.php.

Vous recherchez un outil puissant pour le développement local de WordPress ? DevKinsta propose la création de sites en un clic, le HTTPS intégré, des outils puissants de gestion des e-mails et des bases de données, et bien plus encore. En apprendre plus sur DevKinsta !

Par défaut, les champs « DB_USER » et « DB_PASSWORD » doivent être définis sur « root ». Ce dernier champ est configuré par MAMP. Une installation MySQL normale laissera le champ du mot de passe vide («  »), c’est pourquoi certains guides recommandent de le restaurer à cette valeur.

« DB_HOST » doit être défini sur « localhost ». Vous pouvez également configurer « DB_HOST » comme l’une de ces options, en utilisant le numéro de port désigné par MAMP :

  • ‘DB_HOST’, ‘localhost:8889’
  • ‘DB_HOST’, ‘127.0.0.1:8889’

Pour voir les réglages du port désigné pour MAMP, vous pouvez vous reporter à l’étape 3. Si vous avez corrigé l’un des réglages ci-dessus, enregistrez vos modifications dans le fichier wp-config.php, puis réessayez d’accéder à votre site web via MAMP.

Étape 3 : Vérifiez vos réglages de port (si nécessaire)

Si vous obtenez toujours une erreur de connexion, vous devrez vérifier le port du serveur dans les réglages des préférences de MAMP. Sous Windows, MAMP utilise le port 80 par défaut pour les réglages de port Apache et de port Nginx. Le réglage du port MySQL est 3306.

L'écran des réglages des ports MAMP

L’écran des réglages des ports MAMP

Sur Mac, MAMP utilise les ports 8888, 8889, et 7888 par défaut pour les réglages de port Apache/Nginx/Port MySQL, et 80 & 3306 pour les réglages par défaut de MAMP Web & MySQL.

Réglages du port MAMP

Réglages du port MAMP

Vous devez vérifier que ces valeurs sont correctes dans les réglages de vos applications MAMP (comme indiqué dans les images ci-dessus). Et voilà ! Vous ne devriez plus voir le message « Error establishing a database connection » sur votre installation locale de WordPress.

Résumé

Lorsque vous rencontrez une erreur de connexion dans MAMP, elle est généralement due à une mauvaise correspondance entre le fichier wp-config.php de votre installation WordPress et votre base de données MySQL. En examinant les informations de vos réglages WordPress et en les comparant aux informations d’identification de la base de données, vous pouvez localiser le problème et corriger les réglages pour rétablir la connexion.

Dans l’article, nous avons abordé les causes courantes du message « Erreur lors de l’établissement d’une connexion à la base de données » que vous pouvez voir lorsque vous utilisez MAMP. En général, le moyen le plus simple de résoudre ce problème est de vérifier votre fichier wp-config.php pour vous assurer que le nom de votre base de données, votre identifiant, votre mot de passe et vos réglages d’hôte et de port sont corrects.


Si vous avez aimé ce tutoriel, alors vous allez adorer notre support. Tous les plans d’hébergement de Kinsta incluent le support 24/7 de nos développeurs et ingénieurs WordPress expérimentés. Discutez avec la même équipe qui soutient nos clients du Fortune 500. Découvrez nos plans