wp-config.php

Die wp-config.php ist die zentrale Konfigurationsdatei jeder WordPress-Installation. Sie enthält die Zugangsdaten zur Datenbank, Sicherheitsschlüssel, Tabellenpräfixe und zahlreiche weitere Einstellungen, die das Verhalten von WordPress grundlegend steuern. Die Datei liegt im Hauptverzeichnis der Installation und wird bei jedem Seitenaufruf geladen.

Technischer Hintergrund

Die wp-config.php wird während der WordPress-Installation automatisch erstellt, basierend auf der Vorlage wp-config-sample.php. Die wichtigsten Einträge sind die Datenbank-Verbindungsdaten: DB_NAME, DB_USER, DB_PASSWORD und DB_HOST. Ohne korrekte Werte kann WordPress keine Verbindung zur Datenbank aufbauen und zeigt die bekannte Fehlermeldung „Error establishing a database connection“.

Darüber hinaus enthält die Datei acht Sicherheitsschlüssel und Salts, die WordPress für die Verschlüsselung von Cookies und Sitzungsdaten verwendet. Diese sollten einzigartig und zufällig generiert sein. WordPress bietet dafür einen eigenen Generator unter api.wordpress.org/secret-key. Eine Änderung dieser Schlüssel meldet automatisch alle eingeloggten Benutzer ab.

Über optionale Konstanten lässt sich das Verhalten von WordPress weiter anpassen. WP_DEBUG aktiviert den Debug-Modus für die Fehlersuche. WP_MEMORY_LIMIT erhöht das verfügbare PHP-Speicherlimit. DISALLOW_FILE_EDIT deaktiviert den Datei-Editor im Backend und schließt damit eine häufig ausgenutzte Sicherheitslücke. Auch der Cache, das Cron-System und die REST API lassen sich über die wp-config.php konfigurieren.

Bedeutung für die WordPress-Wartung

Die wp-config.php ist eine der sensibelsten Dateien einer WordPress-Website. Sie enthält im Klartext die Datenbankzugangsdaten und stellt damit ein direktes Sicherheitsrisiko dar, wenn sie in falsche Hände gerät. Bei der Wartung ist es wichtig, diese Datei besonders zu schützen – sowohl durch korrekte Dateiberechtigungen als auch durch serverseitige Zugangsbeschränkungen.

Im Wartungsalltag wird die Datei regelmäßig bearbeitet, etwa um den Debug-Modus zu aktivieren, Speicherlimits anzupassen oder eine Staging-Umgebung zu konfigurieren. Ein fehlerfreier Umgang mit der wp-config.php ist daher Voraussetzung für eine stabile WordPress-Installation.

Häufige Probleme

• Syntaxfehler (fehlende Semikolons, falsche Anführungszeichen) führen zu einem White Screen of Death.
• Falsche Datenbank-Zugangsdaten verursachen die Fehlermeldung „Error establishing a database connection“.
• Die Datei ist öffentlich über den Browser abrufbar, weil die Server-Konfiguration fehlt oder fehlerhaft ist.
• Sicherheitsschlüssel wurden nie geändert oder stammen aus einer kopierten Installation, was die Sitzungssicherheit gefährdet.
• Unvorsichtiges Bearbeiten ohne Backup der Originaldatei führt bei Fehlern zu Ausfallzeiten.

Best Practices

• Die Dateiberechtigungen der wp-config.php auf 440 oder 400 setzen, damit nur der Webserver sie lesen kann.
• Den Zugriff über den Browser per .htaccess oder Serverkonfiguration vollständig blockieren.
• Sicherheitsschlüssel und Salts bei der Ersteinrichtung generieren und bei Verdacht auf Kompromittierung sofort erneuern.
• DISALLOW_FILE_EDIT auf true setzen, um den Datei-Editor im Backend zu deaktivieren.
• Vor jeder Bearbeitung eine Sicherungskopie der Datei erstellen und Änderungen möglichst über WP-CLI oder einen Texteditor auf dem Server vornehmen.
• Die Datei optional ein Verzeichnis oberhalb des Web-Root-Verzeichnisses verschieben – WordPress erkennt sie dort automatisch.