Wie kann ich die WordPress-URLs in der Datenbank aktualisieren?

Alle URLs in der WordPress-Datenbank lassen sich auf eine neue Adresse aktualisieren, entweder mit einem Plugin oder über die Kommandozeile.

Warum müssen die URLs aktualisiert werden?

Dafür gibt es mehrere Gründe:

• Umzug auf eine neue Domain: Der häufigste Grund ist der Wechsel von einer alten auf eine neue Domain, zum Beispiel von https://alte-domain.tld auf https://neue-domain.tld. Nach dem Import der Datenbank werden mit diesen Schritten die enthaltenen URLs aktualisiert.
• www hinzufügen oder entfernen: Auch beim Hinzufügen oder Entfernen von www sollten die URLs angepasst werden. Andernfalls kann es zu Fehlern wie „Too many redirects“ oder „The page isn’t redirecting properly“ kommen.
• HTTPS erzwingen: Nach der Einrichtung eines SSL-Zertifikats ändert sich der Anfang der Adresse von http auf https. Auch alle URLs in der Datenbank sollten dann die HTTPS-Version verwenden.

Welchen Weg soll ich nehmen?

• Weg A: Plugin (empfohlen für die meisten Kunden). Kein SSH nötig, alles über das WordPress-Dashboard. Voraussetzung: Der Login ins Backend funktioniert noch.
• Weg B: WP-CLI über die Kommandozeile (für technisch versierte Nutzer). Schneller und skriptbar, läuft über das cPanel-Terminal (oder SSH).

Backup der Datenbank

Zuerst sichern: Vor jeder Änderung ein Backup der Datenbank anlegen. Das Ersetzen lässt sich nicht per Klick rückgängig machen; mit einem Backup lässt sich der Ausgangszustand jederzeit wiederherstellen. Eine der beiden Varianten wählen.

Variante 1: phpMyAdmin (empfohlen bis ca. 50 MB)

1. In cPanel phpMyAdmin öffnen und links die Datenbank der Website auswählen.
2. Oben auf den Reiter Exportieren klicken.
3. Exportmethode Schnell und Format SQL belassen, dann auf OK bzw. Exportieren klicken.
4. Die heruntergeladene .sql-Datei sicher aufbewahren.

Variante 2: per SSH (auch für grössere Datenbanken)

Bei grösseren Datenbanken empfiehlt sich der Export über die Kommandozeile. Wie das geht, ist Schritt für Schritt beschrieben unter Datenbank per SSH exportieren und importieren.

Weg A: Mit dem Plugin „Better Search Replace“

Empfohlen, solange der Login ins WordPress-Dashboard noch funktioniert. Falls der Login nach dem Umzug nicht mehr möglich ist, müssen zuerst die Werte home und siteurl in der Datenbank auf die neue Adresse gesetzt werden (in phpMyAdmin in der Tabelle wp_options). Danach ist der Login wieder möglich.

1. Backup anlegen (siehe Abschnitt Backup der Datenbank), damit sich die Änderungen bei Bedarf zurücknehmen lassen.
2. Ins WordPress-Dashboard einloggen.
3. Plugin installieren und aktivieren: unter Plugins → Installieren nach „Better Search Replace“ suchen, installieren, aktivieren.
4. Das Plugin unter Werkzeuge → Better Search Replace öffnen (Reiter Suchen/Ersetzen).
5. Im Feld Suchen nach: die alte Adresse eintragen, z. B. http://www.alte-domain.tld
6. Im Feld Ersetzen durch die neue Adresse eintragen, z. B. https://www.neue-domain.tld
7. Unter Tabellen auswählen: alle Tabellen markieren. Mit gedrückter Strg-/Befehlstaste oder mit Umschalt (SHIFT) lassen sich mehrere auswählen. Das Tabellen-Präfix (im Beispiel wpyh_) kann abweichen. Einfach alle vorhandenen Einträge markieren.
8. Unter Zusätzliche Einstellungen das Feld GUIDs ersetzen frei lassen (nicht ankreuzen). Die GUID ist ein fester Kennzeichner für Feed-Reader, kein anzupassender Link. Würde man sie ändern, halten Feed-Reader alte Beiträge für neu. Gross- und Kleinschreibung ignorieren ebenfalls frei lassen.
9. Als Testlauf ausführen ankreuzen und auf Suchen/Ersetzen starten klicken. Beim Testlauf wird die Datenbank nicht verändert; angezeigt wird nur, welche Ersetzungen vorgenommen würden.
10. Kontrollieren, ob die Trefferzahl plausibel ist. Stehen überall Nullen, die Schreibweise der alten Adresse prüfen.
11. Den Haken bei Als Testlauf ausführen entfernen und erneut auf Suchen/Ersetzen starten klicken. Eine Bestätigung zeigt, wie viele Einträge tatsächlich geändert wurden.

So sieht die ausgefüllte Eingabemaske aus (oben die beiden Adressfelder, darunter die Tabellenauswahl, unten der aktivierte Testlauf):

Kommt die alte Adresse in mehreren Schreibweisen vor (mit/ohne www., http:// statt https://), den Vorgang je Variante wiederholen. Zum Schluss unter Einstellungen → Permalinks einmal speichern, um die Permalink-Struktur neu zu schreiben.

Weg B: Mit WP-CLI über die Kommandozeile

Für technisch versierte Nutzer. Geschätzte Dauer: 10 bis 15 Minuten. Benötigt wird der Pfad zur WordPress-Installation, meist ~/public_html oder ~/public_html/ihre-domain.tld.

Schritt 1: Kommandozeile öffnen (Terminal oder SSH)

Terminal im cPanel (empfohlen)

Im cPanel auf Erweiterte Optionen → Terminal klicken (falls die Oberfläche auf Englisch ist: Advanced → Terminal).

Beim erstmaligen Öffnen erscheint eine Warnung, dass ein falscher Umgang mit Befehlszeilen-Tools Daten beschädigen kann. Den Hinweis mit Ich bin mir dessen bewusst und möchte fortfahren (bzw. I understand and want to proceed) bestätigen. Anschliessend öffnet sich ein schwarzes Fenster mit einer Eingabezeile.

Alternativ: SSH

Alternativ mit einem SSH-Client (z. B. PuTTY oder das Terminal des Betriebssystems) verbinden: ssh BENUTZERNAME@SERVER. Die weiteren Befehle sind identisch.

Schritt 2: WP-CLI installieren

mkdir -p ~/bin
cd ~/bin
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
mv wp-cli.phar wp
wp --info

Erscheint command not found, liegt ~/bin nicht im Suchpfad. Dann neu anmelden oder das Werkzeug direkt mit ~/bin/wp aufrufen.

Schritt 3: Ins WordPress-Verzeichnis wechseln

In den Ordner mit der wp-config.php wechseln (WP-CLI liest die Datenbank-Zugangsdaten von dort selbst aus):

cd ~/public_html

Vor dem Fortfahren sicherstellen, dass das Backup (siehe Abschnitt Backup der Datenbank) bereits erstellt ist.

Schritt 4: Testlauf durchführen

Mit --dry-run wird nichts geschrieben, sondern nur angezeigt, was sich ändern würde. Adressen ohne abschliessenden Schrägstrich angeben, so werden auch Links auf die Startseite selbst und Canonical-Tags erfasst.

wp search-replace 'https://www.alte-domain.tld' 'https://www.neue-domain.tld' --all-tables-with-prefix --skip-columns=guid --report-changed-only --dry-run

Schritt 5: Ersetzung ausführen

Derselbe Befehl ohne --dry-run schreibt die Änderungen. --skip-columns=guid lässt die GUID-Spalte unangetastet (die GUID ist ein fester Kennzeichner für Feed-Reader, kein anzupassender Link).

wp search-replace 'https://www.alte-domain.tld' 'https://www.neue-domain.tld' --all-tables-with-prefix --skip-columns=guid --report-changed-only

Schritt 6: Weitere Adressvarianten

Je nach Bestand zusätzliche Läufe für alte Schema-/www-Varianten:

wp search-replace 'http://www.alte-domain.tld' 'https://www.neue-domain.tld' --all-tables-with-prefix --skip-columns=guid --report-changed-only
wp search-replace 'https://alte-domain.tld' 'https://www.neue-domain.tld' --all-tables-with-prefix --skip-columns=guid --report-changed-only
wp search-replace 'http://alte-domain.tld' 'https://www.neue-domain.tld' --all-tables-with-prefix --skip-columns=guid --report-changed-only

Schritt 7: Cache leeren und prüfen

wp cache flush
wp option get home
wp option get siteurl

Bei Verwendung eines Caching-Plugins dessen Cache zusätzlich im Backend leeren.

Hinweise

• Falls die URL-Anpassung nicht selbst durchgeführt werden soll, übernehmen wir das gerne kostenpflichtig im Rahmen des Supports. Dazu bitte ein Ticket über das Kundencenter erstellen.

Weiterführende Dokumentation

• WP-CLI
• Better Search Replace (Plugin)
• Datenbank per SSH exportieren und importieren
• Kann ich via SSH auf meinen Account zugreifen?