7 min de lecture
Le fichier wp-config.php fait partie des éléments qui permettent à WordPress de démarrer correctement. Avant d’y ajouter un réglage trouvé dans un tutoriel, identifiez la bonne installation, le rôle de la ligne et la façon de revenir à l’état précédent. L’objectif est de faire une modification précise, puis d’en vérifier le résultat.
Un fichier au début du parcours
Connexion à la base et réglages propres à l’installation.
Le logiciel utilise ces informations pour fonctionner.
Vous vérifiez le résultat sur le site concerné.
À quoi sert le fichier de configuration WordPress ?
Il contient notamment les informations de connexion à la base de données et des paramètres propres au site. La documentation WordPress sur le fichier de configuration présente ses principales familles de réglages. Tous les sites n’ont pas besoin des mêmes constantes additionnelles.
Trois éléments à distinguer
- La configuration WordPress : elle renseigne le logiciel sur son installation et certains comportements.
- Le fichier .htaccess : il concerne des règles du serveur lorsqu’il les prend en charge.
- Les réglages de l’administration : ce sont les options accessibles dans les écrans du site ou de ses extensions.
Le fichier wp-config.php n’est donc ni votre thème ni un emplacement pour ajouter du code d’affichage. Une demande qui peut être traitée dans un réglage existant ne justifie pas automatiquement de modifier ce fichier. Pour les règles du serveur, consultez plutôt le guide du fichier .htaccess WordPress.
Où se trouve le fichier wp-config.php ?
- Dans une installation classique : cherchez à la racine du dossier WordPress, près de wp-admin, wp-content et wp-includes.
- Si plusieurs sites ou copies existent : confirmez le dossier associé au domaine concerné.
- Si le fichier manque à cet endroit : faites vérifier l’organisation de l’installation avant d’en créer ou d’en déplacer un.
Exemple pédagogique · dossier WordPress
Passez par un accès aux fichiers fourni par l’hébergeur, par exemple son gestionnaire ou un accès SFTP autorisé. Le dossier peut s’appeler différemment selon le compte : ne retenez pas un chemin universel comme preuve que vous êtes au bon endroit.
Sur certaines installations, wp-config.php peut être placé au niveau supérieur ou organisé autrement. La documentation de sécurisation WordPress évoque ce cas. Ne déplacez pas le fichier pour imiter une capture et ne modifiez pas toutes les copies portant le même nom.
Le fichier sample est un modèle. Un fichier nommé wp-config-sample.php ne démontre pas que la configuration active manque. Sur un site déjà installé, identifiez ce qui est réellement chargé avant toute création ou substitution.
Comment lire le fichier sans confondre les réglages ?
Commencez par lire une copie de wp-config.php sans l’enregistrer sur le serveur. Repérez les commentaires, les constantes déjà définies et la fin du fichier. Une ligne absente de votre copie n’est pas forcément un oubli : certaines installations utilisent des valeurs fournies autrement.
Extrait fictif et incomplet · lecture uniquement
define( 'DB_NAME', 'base_exemple' );
define( 'DB_HOST', 'mysql.exemple.test' );
$table_prefix = 'exemple_';DB_NAMELe nom de la base à utiliser.
DB_HOSTL’hôte de base fourni par l’hébergeur.
table_prefixLe préfixe qui identifie les tables de cette installation.
Les informations de base de données ne sont pas les identifiants de connexion à l’administration WordPress. Ne remplacez pas une valeur parce qu’elle ne ressemble pas à votre adresse de site. Dans un fichier wp-config.php, chaque réglage doit correspondre à l’environnement réellement utilisé.
| Famille | Ce qu’elle concerne | Quand la vérifier |
|---|---|---|
| Connexion à la base | Nom, utilisateur, mot de passe et hôte de la base. | Lors d’un changement confirmé de ces informations. |
| Clés de sécurité | Éléments utilisés par WordPress pour ses mécanismes d’authentification. | Dans une intervention de sécurité préparée. |
| Adresses et environnement | Constantes d’URL ou indications propres à l’installation, lorsqu’elles sont présentes. | Dans un changement d’environnement précisément identifié. |
| Diagnostic et automatisations | Options liées au débogage ou aux tâches planifiées. | Pour un besoin documenté, avec contrôle et suivi. |
Gardez les secrets hors des captures et des messages. Masquez les mots de passe, clés et autres valeurs privées avant de partager un extrait. Évitez également de laisser une copie du fichier accessible publiquement dans le dossier du site.
Comment modifier wp-config.php sans perdre les réglages existants ?
- Préservez l’état actuel : une copie protégée du fichier, une sauvegarde récupérable et les accès nécessaires.
- Changez un seul réglage identifié : contrôlez sa présence et sa documentation avant d’ajouter une ligne.
- Vérifiez puis documentez : le comportement attendu, les parcours du site et le retour arrière disponible.
Avant de modifier wp-config.php, assurez-vous de pouvoir remettre le fichier précédent même si l’administration ne s’ouvre plus. Le guide pour sauvegarder et restaurer WordPress détaille la préparation d’une copie récupérable. Si le réglage peut être essayé sur une copie adaptée, commencez par un site de test protégé.
Une modification ciblée dans un éditeur de code
- Ouvrez la copie avec un éditeur de texte ou de code. Un traitement de texte peut transformer les guillemets ou ajouter une mise en forme incompatible.
- Recherchez le réglage existant. Ne collez pas une seconde définition de la même constante à la fin du fichier.
- Conservez la structure et les valeurs non concernées. Suivez l’emplacement prévu par la documentation du réglage et l’organisation propre à votre installation.
- Relisez la différence avant l’envoi. Vérifiez les guillemets, parenthèses et points-virgules, puis transférez seulement le fichier prévu.
La documentation officielle sur l’édition des fichiers précise les précautions de sauvegarde et d’éditeur. Ne remplacez pas votre wp-config.php par un « fichier optimisé » complet trouvé ailleurs : les paramètres de cette autre installation ne sont pas les vôtres.
Quels réglages répondent à un besoin précis ?
Le but n’est pas d’activer toutes les options de wp-config.php. Pour chaque changement, écrivez le problème à résoudre et le résultat qui permettra de savoir si le réglage est adapté. Voici trois situations à distinguer.
Examiner une erreur technique
Le débogage peut aider à recueillir une information manquante. Il ne faut pas afficher des erreurs privées aux visiteurs ni considérer l’activation d’un journal comme une réparation. Le guide sur l’erreur critique WordPress présente le parcours de diagnostic sans refaire ici tous ses réglages.
Revoir le déclenchement des tâches
Une constante liée à WP-Cron peut faire partie d’une configuration volontaire. Avant de la changer dans wp-config.php, identifiez le mécanisme existant et le relais éventuel. Le guide du cron WordPress explique les contrôles de programmation et d’exécution.
Lors d’une migration, vérifiez séparément les informations propres au nouvel environnement. Une erreur de connexion ne se corrige pas en essayant des identifiants au hasard. Le guide de migration WordPress permet de replacer cette vérification dans la préparation de la bascule.
Que vérifier après l’enregistrement du fichier ?
Un transfert terminé ne suffit pas à valider une modification de wp-config.php. Contrôlez le résultat recherché et les parcours importants. Si une page ne répond plus juste après le changement, notez le message et l’heure avant d’enchaîner d’autres modifications.
Un changement, un contrôle, une décision
- 1Enregistrer
Le seul fichier et le réglage prévus.
- 2Parcourir
Pages publiques et administration.
- 3Constater
Résultat attendu et erreurs éventuelles.
- 4Décider
Conserver le changement ou rétablir la copie préservée.
Une recette courte et reproductible
- L’accès : ouvrez plusieurs pages et l’administration avec le compte autorisé.
- Les fonctions : vérifiez celles qui comptent pour le site, sans créer involontairement une commande ou un envoi réel.
- Le réglage : recherchez son effet attendu, pas uniquement l’absence d’un écran d’erreur.
- La trace : conservez la date, le changement effectué, le contrôle et les réserves.
Si le site ne fonctionne plus, utilisez l’accès aux fichiers conservé pour rétablir la version précédente lorsque ce retour correspond à l’intervention. Si le problème persiste, reprenez le diagnostic : ne supposez pas que toute panne vient du dernier fichier modifié.
Questions fréquentes sur la configuration WordPress
Peut-on modifier ce fichier depuis l’administration ?
Les éditeurs intégrés de thèmes et d’extensions ne sont pas un éditeur général de la configuration. Préférez l’accès aux fichiers prévu par votre hébergement ou la procédure de votre intervenant. Installer une extension uniquement pour ouvrir ce fichier ajoute une modification supplémentaire à justifier.
Un fichier absent signifie-t-il que le site est cassé ?
Pas à lui seul. Vérifiez le dossier consulté et l’organisation de l’installation. Un site qui fonctionne peut charger sa configuration depuis un emplacement différent de celui que vous regardez. Faites confirmer le fichier actif avant d’en créer un autre.
Peut-on copier la configuration du site de test en production ?
Ne la copiez pas intégralement sans comparaison. Les identifiants de base, chemins, URL ou réglages d’environnement peuvent être différents. Transférez les seuls changements nécessaires dans le cadre d’une bascule préparée.
Faut-il changer les permissions pour pouvoir enregistrer ?
Une erreur d’accès demande de vérifier le compte et les permissions attendues avec l’hébergeur. N’ouvrez pas largement les droits pour faire disparaître le message. Le fichier doit rester protégé selon la configuration du serveur.
Conserver une configuration que l’on peut suivre
Après une intervention, gardez une explication simple du réglage, de sa raison et de son contrôle. Cet historique facilite la prochaine mise à jour ou le changement d’intervenant. Mon accompagnement en maintenance WordPress permet de définir le suivi technique utile à votre site. Le fichier wp-config.php reste ainsi un élément identifié de l’installation, plutôt qu’une accumulation de lignes ajoutées sans suivi.
