Wat is WP-config.php

Werk je met WordPress en kom je het bestand wp-config.php tegen, maar weet je niet goed wat je ermee moet doen? Dit bestand lijkt technisch en gevoelig – en dat is het ook – maar als je de basis begrijpt, kun je veel beter inschatten wat je wél en juist niet moet aanpassen.

Wat is wp-config.php in WordPress?

Het bestand wp-config.php is het configuratiebestand van je WordPress-website. WordPress leest dit bestand elke keer als iemand je site bezoekt. Hierin staan belangrijke instellingen die bepalen hoe je site verbinding maakt met de database en hoe WordPress zich gedraagt.

Je vindt de config in de hoofdmap (root) van je WordPress-installatie. Zonder dit bestand kan WordPress niet goed werken. Raak het dus alleen aan als je weet wat je doet of als je een duidelijke handleiding volgt.

Welke gegevens staan er in wp-config.php?

In wp-config.php zet WordPress cruciale gegevens, zoals:

de naam van je database;
de gebruikersnaam en het wachtwoord van de database;
de databasehost (meestal ‘localhost’ of een serveradres);
de “salt keys” (veiligheidssleutels die inlogcookies extra beveiligen).

Met deze gegevens maakt je site verbinding met de database. Klopt er iets niet, dan krijg je vaak een foutmelding zoals “Error establishing a database connection”. Daarom is het belangrijk dat je dit bestand goed beveiligt en de inloggegevens nooit deelt met anderen.

Bij een handmatige installatie

Installeer je WordPress handmatig, dan zie je eerst geen wp-config.php, maar een bestand met de naam wp-config-sample.php. Dat is een voorbeeldbestand. Je vult hier je databasegegevens in en slaat het daarna op als wp-config.php.

Pas als dit bestand correct is ingevuld en hernoemd, kan WordPress verbinding maken met de database tijdens de installatie. Vul je gegevens dus zorgvuldig in en controleer ze bij twijfel bij je hostingprovider. Een fout in één regel kan al genoeg zijn om de installatie te laten mislukken.

Gebruiken het om problemen op te lossen

Je kunt wp-config.php ook gebruiken om bepaalde problemen op te sporen of extra instellingen te doen die je anders via een plugin zou regelen. Veelgebruikte voorbeelden zijn:

de debug-modus inschakelen (WP_DEBUG) om foutmeldingen te tonen;
het aantal revisies van berichten beperken;
automatische updates uitzetten of anders instellen;
de WordPress-database repareren met een speciale reparatie-optie.

Zet je debug-modus aan, doe dat dan alleen tijdelijk op een testomgeving of op een rustig moment. Schakel debug daarna weer uit, zodat bezoekers geen technische foutmeldingen zien die gevoelige informatie kunnen prijsgeven.

Veilig werken met wp-config.php

Omdat wp-config.php zo veel gevoelige informatie bevat, moet je hier extra voorzichtig mee omgaan. Een paar praktische tips:

maak altijd een back-up voordat je het bestand wijzigt;
bewerk wp-config.php bij voorkeur via een veilige verbinding (SFTP of de file manager van je hosting);
deel het bestand nooit via e-mail of chat;
kopieer geen stukjes code van onbekende bronnen zonder te begrijpen wat ze doen.

Twijfel je over een wijziging? Vraag dan advies aan je hostingpartij of een ontwikkelaar. Zo voorkom je dat een kleine fout je hele WordPress-site onbereikbaar maakt.