WordPress mit einer MySQL-Datenbank verbinden

WordPress mit einer MySQL-Datenbank verbinden: wp-config.php richtig einrichten

WordPress benötigt eine MySQL- oder MariaDB-Datenbank, um Inhalte, Benutzer, Einstellungen, Kommentare, Menüs und viele Plugin-Daten zu speichern. Die Verbindung zwischen WordPress und der Datenbank wird über die Datei wp-config.php gesteuert.

Wenn diese Zugangsdaten falsch sind, erscheint häufig die Fehlermeldung „Error establishing a database connection“ beziehungsweise „Fehler beim Aufbau einer Datenbankverbindung“.

Wichtig: Bearbeiten Sie die Datei wp-config.php sorgfältig. Schon ein falsches Zeichen, ein fehlendes Anführungszeichen oder ein falsches Passwort kann dazu führen, dass WordPress keine Verbindung mehr zur Datenbank herstellen kann.

Welche Daten benötigt WordPress?

Für die Datenbankverbindung benötigt WordPress vier zentrale Angaben: Datenbankname, Datenbank-Benutzer, Passwort und Datenbank-Host.

Eintrag in WordPress	Bedeutung	Beispiel
`DB_NAME`	Name der Datenbank	`benutzer_wordpress`
`DB_USER`	Datenbank-Benutzer	`benutzer_wpuser`
`DB_PASSWORD`	Passwort des Datenbank-Benutzers	Ihr gesetztes Datenbank-Passwort
`DB_HOST`	Datenbankserver	`localhost`

Hinweis: Bei normalen WordPress-Installationen auf cPanel-Hosting ist der Datenbank-Host häufig localhost. Verwenden Sie einen anderen Wert nur dann, wenn dies in Ihrer Hosting-Umgebung ausdrücklich angegeben ist.

Das cPanel-Präfix nicht vergessen

In cPanel werden Datenbanknamen und Datenbank-Benutzer häufig automatisch mit einem Präfix versehen. Dieses Präfix basiert meist auf dem cPanel-Benutzernamen und wird mit einem Unterstrich ergänzt.

Wenn Sie im Datenbank-Assistenten zum Beispiel wordpress als Datenbankname eingeben, kann der vollständige Name in cPanel so aussehen:

benutzer_wordpress

Genau dieser vollständige Name muss später in der wp-config.php eingetragen werden. Dasselbe gilt für den Datenbank-Benutzer.

Eingabe im Assistenten	Vollständiger cPanel-Name	In WordPress verwenden?
`wordpress`	`benutzer_wordpress`	Ja, vollständigen Namen verwenden
`wpuser`	`benutzer_wpuser`	Ja, vollständigen Namen verwenden

wp-config.php bearbeiten

Die Datei wp-config.php befindet sich normalerweise im Hauptverzeichnis Ihrer WordPress-Installation. Sie können sie über den cPanel-Dateimanager oder per FTP bearbeiten.

Melden Sie sich in cPanel an.
Öffnen Sie den Dateimanager.
Wechseln Sie in das Verzeichnis Ihrer WordPress-Website, häufig public_html oder ein Unterverzeichnis.
Suchen Sie die Datei wp-config.php.
Erstellen Sie vor der Bearbeitung eine Sicherungskopie der Datei.
Öffnen Sie die Datei zur Bearbeitung.
Prüfen oder ändern Sie die Datenbankeinträge.
Speichern Sie die Datei und testen Sie die Website.

Empfehlung: Speichern Sie vor Änderungen eine Kopie der Datei, zum Beispiel als wp-config-backup.php. Achten Sie jedoch darauf, solche Sicherungskopien nicht dauerhaft öffentlich erreichbar liegen zu lassen.

Beispiel für die Datenbankeinträge in wp-config.php

Die relevanten Zeilen in der wp-config.php sehen typischerweise so aus:

define( 'DB_NAME', 'benutzer_wordpress' );
define( 'DB_USER', 'benutzer_wpuser' );
define( 'DB_PASSWORD', 'IhrDatenbankPasswort' );
define( 'DB_HOST', 'localhost' );

Ersetzen Sie die Beispielwerte durch die tatsächlichen Daten Ihrer Datenbank. Verwenden Sie dabei exakt die Schreibweise aus cPanel.

Datenbank-Benutzer der Datenbank zuweisen

Ein häufiger Fehler besteht darin, dass Datenbank und Datenbank-Benutzer zwar erstellt wurden, der Benutzer aber nicht mit der Datenbank verknüpft ist. WordPress kann dann trotz korrektem Namen und Passwort keine Verbindung herstellen.

So prüfen Sie die Zuordnung:

Öffnen Sie in cPanel die Funktion MySQL-Datenbanken.
Suchen Sie den Bereich Benutzer zu Datenbank hinzufügen.
Wählen Sie den passenden Datenbank-Benutzer aus.
Wählen Sie die richtige Datenbank aus.
Klicken Sie auf Hinzufügen.
Wählen Sie für WordPress in der Regel ALLE BERECHTIGUNGEN.
Speichern Sie die Auswahl.

Ohne passende Berechtigungen kann WordPress keine Tabellen lesen, schreiben oder aktualisieren. Das kann zu Installationsfehlern, Update-Problemen oder Datenbankverbindungsfehlern führen.

Häufige Fehler bei der WordPress-Datenbankverbindung

Fehler	Mögliche Ursache	Lösung
Fehler beim Aufbau einer Datenbankverbindung	Falscher Datenbankname, Benutzername oder Passwort	Einträge in `wp-config.php` prüfen
Access denied	Benutzer ist nicht zugewiesen oder Passwort ist falsch	Benutzerrechte in MySQL-Datenbanken prüfen
Unknown database	Datenbankname ist falsch oder ohne Präfix eingetragen	Vollständigen Datenbanknamen aus cPanel verwenden
Website bleibt weiss	PHP-Fehler, Plugin-Konflikt oder Konfigurationsfehler	Error Logs prüfen und letzte Änderungen rückgängig machen

Nach einem WordPress-Umzug prüfen

Nach einer Migration oder Wiederherstellung von WordPress müssen Datenbank und Dateien zusammenpassen. Besonders wichtig ist, dass die importierte Datenbank auch in der wp-config.php eingetragen ist.

Datenbank importiert? Prüfen Sie in phpMyAdmin, ob die Tabellen vorhanden sind.
Richtige Datenbank eingetragen? Kontrollieren Sie DB_NAME.
Richtiger Benutzer eingetragen? Kontrollieren Sie DB_USER.
Passwort aktuell? Wenn Sie das Passwort in cPanel geändert haben, muss es auch in WordPress angepasst werden.
Benutzerrechte korrekt? Der Benutzer sollte der Datenbank zugewiesen sein.
Domain geändert? Bei Domainwechseln können zusätzliche Anpassungen an WordPress-URLs notwendig sein.

Hinweis bei Domainwechseln: Wenn WordPress nach einem Umzug auf die alte Domain weiterleitet, liegt das meist nicht an der Datenbankverbindung selbst, sondern an gespeicherten WordPress-URLs in der Datenbank oder an Weiterleitungen in der Website-Konfiguration.

Tabellenpräfix in WordPress

Neben den Datenbank-Zugangsdaten enthält die wp-config.php auch das Tabellenpräfix. Dieses legt fest, mit welchem Präfix WordPress-Tabellen in der Datenbank beginnen.

$table_prefix = 'wp_';

Das Tabellenpräfix muss zu den Tabellen in Ihrer Datenbank passen. Wenn Ihre Tabellen zum Beispiel wp_posts, wp_options und wp_users heissen, ist wp_ korrekt. Wenn die Tabellen ein anderes Präfix verwenden, muss dieser Wert entsprechend angepasst werden.

Achtung: Ändern Sie das Tabellenpräfix nicht beliebig. Wenn der Wert nicht zu den tatsächlichen Tabellen in der Datenbank passt, findet WordPress seine Inhalte und Einstellungen nicht mehr korrekt.

Sicherheit rund um wp-config.php

Die Datei wp-config.php enthält sensible Zugangsdaten zur Datenbank. Behandeln Sie diese Datei deshalb besonders vorsichtig.

Geben Sie den Inhalt der Datei nicht öffentlich weiter.
Speichern Sie Datenbank-Passwörter nicht in ungeschützten Notizen oder öffentlichen Dateien.
Verwenden Sie starke, einzigartige Datenbank-Passwörter.
Löschen Sie nicht benötigte Kopien der wp-config.php wieder.
Ändern Sie das Datenbank-Passwort nur, wenn Sie es anschliessend auch in WordPress aktualisieren.

Zusammenfassung

Die Verbindung zwischen WordPress und Ihrer MySQL- oder MariaDB-Datenbank wird über die Datei wp-config.php gesteuert. Entscheidend sind der vollständige Datenbankname, der vollständige Datenbank-Benutzer, das korrekte Passwort und der passende Datenbank-Host.

Bei cPanel-Hosting ist besonders wichtig, das automatische Präfix bei Datenbanknamen und Benutzern nicht zu vergessen. Zusätzlich muss der Datenbank-Benutzer der richtigen Datenbank zugewiesen sein und über ausreichende Berechtigungen verfügen.

Ihre WordPress-Website zeigt einen Datenbankverbindungsfehler oder funktioniert nach einem Umzug nicht korrekt?
Das CURIAWEB-Technikteam unterstützt Sie gerne bei der Prüfung von wp-config.php, Datenbankzugang und Benutzerrechten.

Support-Ticket eröffnen

WordPress mit einer MySQL-Datenbank verbinden