Connecter WordPress à une base de données MySQL

Connecter WordPress à une base de données MySQL : Configurer correctement le fichier wp-config.php

WordPress a besoin d'une base de données MySQL ou MariaDB pour stocker ses contenus, ses utilisateurs, ses réglages, ses commentaires, ses menus et de nombreuses données d'extensions. La connexion entre WordPress et la base de données est gérée via le fichier wp-config.php.

Si ces informations de connexion sont incorrectes, le message d'erreur suivant s'affiche fréquemment : « Erreur lors de la connexion à la base de données » (ou “Error establishing a database connection”).

Important : Modifiez le fichier wp-config.php avec la plus grande prudence. Un seul caractère erroné, un guillemet manquant ou un mauvais mot de passe peut empêcher WordPress de se connecter à votre base de données.

Quelles sont les données requises par WordPress ?

Pour établir la connexion, WordPress nécessite quatre informations centrales : le nom de la base de données, l'utilisateur de la base de données, le mot de passe et l'hôte de la base de données.

Saisie dans WordPress	Signification	Exemple
`DB_NAME`	Nom de la base de données	`utilisateur_wordpress`
`DB_USER`	Utilisateur de la base de données	`utilisateur_wpuser`
`DB_PASSWORD`	Mot de passe de l'utilisateur de la base	Votre mot de passe de base de données
`DB_HOST`	Serveur de la base de données	`localhost`

Remarque : Pour les installations WordPress standards sur un hébergement cPanel, l'hôte de la base de données est presque toujours localhost. N'utilisez une autre valeur que si cela est explicitement indiqué par votre environnement d'hébergement.

Ne pas oublier le préfixe cPanel

Dans cPanel, les noms de bases de données et les utilisateurs sont souvent automatiquement complétés par un préfixe. Ce préfixe est généralement basé sur votre nom d'utilisateur cPanel, suivi d'un caractère de soulignement (underscore).

Par exemple, si vous saisissez wordpress comme nom de base de données dans l'assistant, le nom complet dans cPanel ressemblera à ceci :

utilisateur_wordpress

C'est précisément ce nom complet qui devra être renseigné plus tard dans le fichier wp-config.php. La même règle s'applique pour l'utilisateur de la base de données.

Saisie dans l'assistant	Nom complet cPanel	À utiliser dans WordPress ?
`wordpress`	`utilisateur_wordpress`	Oui, utiliser le nom complet
`wpuser`	`utilisateur_wpuser`	Oui, utiliser le nom complet

Modifier le fichier wp-config.php

Le fichier wp-config.php se trouve normalement dans le répertoire racine (principal) de votre installation WordPress. Vous pouvez le modifier via le Gestionnaire de fichiers cPanel ou par FTP.

Connectez-vous à cPanel.
Ouvrez le Gestionnaire de fichiers.
Rendez-vous dans le répertoire de votre site WordPress, souvent public_html ou un sous-dossier dédié.
Recherchez le fichier wp-config.php.
Créez une copie de sauvegarde du fichier avant toute modification.
Ouvrez le fichier pour le modifier.
Vérifiez ou ajustez les entrées de la base de données.
Enregistrez le fichier et testez le site web.

Recommandation : Enregistrez toujours une copie du fichier avant d'effectuer des modifications, par exemple sous le nom wp-config-backup.php. Veillez cependant à ne pas laisser ces copies de sauvegarde accessibles publiquement de manière permanente.

Exemple d'entrées de base de données dans wp-config.php

Les lignes concernées dans le fichier wp-config.php ressemblent généralement à ceci :

define( 'DB_NAME', 'utilisateur_wordpress' );
define( 'DB_USER', 'utilisateur_wpuser' );
define( 'DB_PASSWORD', 'VotreMotDePasseDeBase' );
define( 'DB_HOST', 'localhost' );

Remplacez les valeurs d'exemple par les données réelles de votre base de données en respectant scrupuleusement l'orthographe exacte présente dans cPanel.

Associer l'utilisateur à la base de données

Une erreur fréquente consiste à créer la base de données et l'utilisateur, mais à oublier de lier l'utilisateur à cette base. WordPress ne pourra alors pas établir la connexion, malgré un nom et un mot de passe corrects.

Comment vérifier cette liaison :

Dans cPanel, ouvrez la fonctionnalité Bases de données MySQL.
Faites défiler jusqu'à la section Ajouter un utilisateur à la base de données.
Sélectionnez l'utilisateur de base de données correspondant.
Sélectionnez la bonne base de données.
Cliquez sur Ajouter.
Pour WordPress, cochez généralement la case TOUS LES PRIVILÈGES.
Enregistrez les modifications.

Sans privilèges appropriés, WordPress ne peut pas lire, écrire ou mettre à jour les tables. Cela peut provoquer des erreurs d'installation, des problèmes de mise à jour ou des pannes de connexion à la base de données.

Erreurs fréquentes liées à la connexion de base de données WordPress

Erreur	Cause possible	Solution
Erreur lors de la connexion à la base de données	Nom de base, identifiant ou mot de passe incorrect	Vérifier les valeurs dans `wp-config.php`
Access denied	L'utilisateur n'est pas associé ou le mot de passe est faux	Vérifier les droits dans Bases de données MySQL
Unknown database	Nom de base erroné ou saisi sans son préfixe	Utiliser le nom complet fourni par cPanel
Page blanche (White Screen of Death)	Erreur PHP, conflit d'extensions ou erreur de configuration	Consulter les journaux d'erreurs (Error Logs) et annuler les derniers changements

À vérifier après un déménagement de site WordPress

Après une migration ou la restauration de WordPress, la base de données et les fichiers doivent correspondre parfaitement. Il est particulièrement crucial que la base de données importée soit bien celle configurée dans le fichier wp-config.php.

Base de données importée ? Vérifiez dans phpMyAdmin que les tables sont bien visibles.
Bonne base de données renseignée ? Contrôlez la constante DB_NAME.
Bon utilisateur renseigné ? Contrôlez la constante DB_USER.
Mot de passe à jour ? Si vous avez changé le mot de passe dans cPanel, il doit être modifié à l'identique dans WordPress.
Privilèges utilisateur corrects ? L'utilisateur doit être rattaché à la base de données.
Changement de domaine ? Si vous changez de nom de domaine, des adaptations supplémentaires sur les URL WordPress au sein de la base de données peuvent être nécessaires.

Remarque en cas de changement de domaine : Si WordPress redirige vers l'ancien domaine après un déménagement, cela ne vient généralement pas de la connexion à la base de données elle-même, mais plutôt des URL WordPress enregistrées dans la base ou de redirections configurées dans les fichiers du site.

Préfixe des tables dans WordPress

En plus des accès à la base de données, le fichier wp-config.php contient également le préfixe des tables. Celui-ci détermine par quelles lettres commencent les tables WordPress dans la base de données.

$table_prefix = 'wp_';

Le préfixe des tables doit impérativement correspondre à celui des tables réelles de votre base de données. Si vos tables se nomment par exemple wp_posts, wp_options et wp_users, la valeur wp_ est correcte. Si vos tables utilisent un autre préfixe, cette valeur doit être ajustée en conséquence.

Attention : Ne modifiez pas le préfixe des tables de manière arbitraire. Si cette valeur ne correspond pas aux tables présentes dans la base de données, WordPress ne sera plus en mesure de trouver ses contenus et ses réglages.

Sécurité autour du fichier wp-config.php

Le fichier wp-config.php contient des identifiants sensibles d'accès à la base de données. Manipulez ce fichier avec la plus grande réserve.

Ne partagez jamais publiquement le contenu de ce fichier.
Ne stockez pas les mots de passe de base de données dans des notes non protégées ou des fichiers publics.
Utilisez des mots de passe de base de données forts et uniques.
Supprimez les copies inutiles du fichier wp-config.php après vos interventions.
Ne modifiez le mot de passe de la base de données que si vous êtes prêt à le mettre à jour immédiatement dans WordPress.

En résumé

La connexion entre WordPress et votre base de données MySQL ou MariaDB est entièrement pilotée par le fichier wp-config.php. Les éléments déterminants sont le nom complet de la base, l'utilisateur complet, le mot de passe exact et l'hôte correspondant.

Sur un hébergement cPanel, il est capital de ne pas omettre le préfixe automatique attribué aux noms de bases et aux utilisateurs. De plus, l'utilisateur doit être associé à la bonne base de données et posséder des privilèges suffisants.

Votre site WordPress affiche une erreur de connexion à la base de données ou ne fonctionne pas correctement après un déménagement ?
L'équipe technique CURIAWEB se tient à votre disposition pour vérifier votre fichier wp-config.php, vos accès à la base de données et les privilèges utilisateurs.

Ouvrir un ticket de support

Connecter WordPress à une base de données MySQL