Le fichier wp-config.php définit le lien vital entre un site WordPress et sa base de données. Il contient des éléments sensibles comme les identifiants MySQL, les clés de sécurité et des constantes qui modulent le comportement du CMS.
Gérer ce fichier avec rigueur évite des pannes, des failles et des pertes de données, tout en permettant d’optimiser la performance et la sécurité.
Contents
- 1 Qu’est-ce que le fichier wp-config.php ?
- 2 Rôles essentiels
- 3 Comment configurer wp-config.php correctement
- 4 Paramètres clés et bonnes pratiques
- 5 Table des constantes fréquemment modifiées
- 6 Précautions à prendre
- 7 Cas pratique : migration et optimisation
- 8 Table des permissions recommandées
- 9 Erreurs courantes et solutions rapides
- 10 Points essentiels pour la suite
- 11 FAQ
Qu’est-ce que le fichier wp-config.php ?
Le fichier wp-config.php se trouve à la racine de l’installation WordPress et charge des paramètres indispensables au fonctionnement du site. Il sert à la fois de fichier de configuration et de référentiel pour des constantes globales utilisées par WordPress.
On y stocke notamment le nom de la base, l’utilisateur, le mot de passe et l’hôte MySQL, ainsi que les salts et autres clés pour chiffrer les cookies.
Rôles essentiels
Connexion à la base de données
Sans les constantes DB_NAME, DB_USER, DB_PASSWORD et DB_HOST, WordPress ne peut ni lire ni écrire les contenus de votre site. Ces valeurs sont l’équivalent d’une clé d’accès à la base et doivent être correctement renseignées et protégées.
Sécurité et intégrité
Les clés définies comme AUTH_KEY ou SECURE_AUTH_KEY renforcent la sécurité des cookies et réduisent les risques de détournement de sessions. Leur remplacement périodique et l’usage de valeurs longues et aléatoires constituent une bonne pratique simple à mettre en œuvre.
Personnalisation du comportement
Des constantes comme WP_DEBUG, WP_MEMORY_LIMIT ou WP_AUTO_UPDATE_CORE permettent de personnaliser le comportement de WordPress sans modifier le cœur du CMS. Ces ajustements sont souvent préférables aux hacks de thèmes ou plugins.
Comment configurer wp-config.php correctement
Commencez par copier wp-config-sample.php et renommez la copie en wp-config.php. Utilisez un éditeur de texte simple et évitez les éditeurs qui ajoutent des caractères invisibles.
Remplacez les placeholders par vos paramètres réels, puis sauvegardez et testez le site. Une erreur de syntaxe suffit à provoquer une page blanche ou un message d’erreur MySQL.
Paramètres clés et bonnes pratiques
Voici les éléments à vérifier en priorité :
- Informations MySQL : DB_NAME, DB_USER, DB_PASSWORD, DB_HOST.
- Clés de sécurité : AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY et les salts associés.
- Préfixe des tables : éviter le standard wp_ pour réduire l’impact des scripts automatisés.
Ajoutez aussi des définitions utiles selon vos besoins, comme WP_MEMORY_LIMIT pour les sites gourmands et DISALLOW_FILE_EDIT pour empêcher l’édition de fichiers depuis l’administration.
Table des constantes fréquemment modifiées
| Constante | Rôle | Exemple |
|---|---|---|
| DB_NAME | Nom de la base de données utilisée par WordPress | ‘site_prod’ |
| DB_HOST | Adresse du serveur MySQL | ‘localhost’ ou ‘mysql.example.com’ |
| WP_MEMORY_LIMIT | Quantité de mémoire PHP allouée au processus WordPress | ‘256M’ |
| DISALLOW_FILE_EDIT | Désactive l’éditeur de thème/plugin dans l’admin | true |
Précautions à prendre
Avant toute modification, effectuez une sauvegarde complète du site et de la base de données. Une sauvegarde vous permet de restaurer un état fonctionnel en cas d’erreur humaine.
- Permissions : définissez les permissions du fichier sur 644 quand c’est possible.
- Éditeur : privilégiez un éditeur qui n’ajoute pas d’encodage ou de BOM.
Vérifiez la syntaxe PHP après chaque modification et testez les pages critiques du site, comme le front-end, l’administration et les formulaires transactionnels.
Cas pratique : migration et optimisation
Lors d’une migration d’un site de test vers un serveur de production, une équipe a dû ajuster DB_HOST, DB_NAME et les salts pour refléter le nouvel environnement. La bascule a été effectuée en moins de deux heures grâce à une procédure documentée et à des sauvegardes automatisées.
Sur le même projet, l’augmentation de WP_MEMORY_LIMIT de 64M à 256M a réduit les erreurs liées aux scripts lourds et limité les interruptions durant les pics de trafic. Le taux d’erreurs 500 a chuté de façon mesurable après l’intervention.
Astuce : utilisez le générateur officiel de clés WordPress pour obtenir des valeurs aléatoires et uniques à chaque installation.
Table des permissions recommandées
| Fichier / dossier | Permission recommandée | Pourquoi |
|---|---|---|
| wp-config.php | 644 | Protège l’écriture tout en permettant la lecture par le serveur web |
| wp-content | 755 | Permet l’ajout de fichiers par le serveur sans trop ouvrir les accès |
Erreurs courantes et solutions rapides
Une erreur fréquente est l’oubli d’un point-virgule ou d’une apostrophe mal appariée, conduisant à une erreur de parsing PHP. Relire attentivement les lignes modifiées et vérifier l’encodage du fichier corrige souvent le problème.
Un autre cas classique est l’utilisation d’un DB_HOST incorrect lorsque la base est fournie par un service externe. Demandez les paramètres exacts à l’hébergeur et testez la connexion via un client MySQL pour valider.
Points essentiels pour la suite
Le fichier wp-config.php demande du respect : sauvegardes régulières, permissions serrées et clés uniques. En documentant chaque modification et en automatisant les sauvegardes, on minimise les risques et on accélère les rétablissements.
Enfin, privilégiez des valeurs claires pour la mémoire, désactivez l’édition de fichiers depuis l’admin en production et changez le préfixe des tables si nécessaire. Ces gestes simples offrent un gain tangible en sécurité et en stabilité.
FAQ
Le fichier wp-config.php est le fichier de configuration principal de WordPress, situé à la racine de l’installation. Il contient les identifiants de la base de données, les clés de sécurité (salts) et des constantes qui modulent le comportement du site.
Sécurisez wp-config.php en limitant les permissions (par exemple 644), en utilisant des clés uniques générées officiellement, en désactivant l’édition de fichiers depuis l’admin, en effectuant des sauvegardes régulières et en, si possible, déplaçant le fichier en dehors de la racine web.
En priorité renseignez correctement DB_NAME, DB_USER, DB_PASSWORD et DB_HOST. Ensuite, mettez à jour les clés de sécurité (AUTH_KEY, SECURE_AUTH_KEY, etc.), ajustez WP_MEMORY_LIMIT si nécessaire et activez ou désactivez WP_DEBUG selon l’environnement.
Si le site plante, restaurez la sauvegarde du fichier, vérifiez la syntaxe PHP (points-virgules, guillemets), contrôlez l’encodage pour supprimer le BOM, testez la connexion MySQL et activez WP_DEBUG en environnement de développement pour diagnostiquer précisément l’erreur.

