URL einer WordPress-Website ändern

Um die URL einer WordPress-Website zu ändern – beispielsweise wenn eine ganz andere Domain genutzt oder auch nur das Protokoll von http:// auf https:// umgestellt werden soll – gibt es mehrere Lösungen. Zwei davon stelle ich hier vor.

Wichtige Infos, bevor ihr beginnt

• Die neue Domain sollte bereits auf den Ordner der Installation zeigen, damit ihr sie nach der Änderung direkt unter der neuen Adresse erreichen könnt – andernfalls könnt ihr die Website nach der Änderung nicht mehr aufrufen (außer, ihr ändert nur das Protokoll – dann erhaltet ihr ohne gültiges SSL-Zertifikat aber eine Warnung vom Browser).
• Erstellt am besten vorher ein Backup, nur zur Sicherheit.
• Ändert in der Datenbank nicht den Wert der guid-Spalte (dadurch würden für Feedreader alle eure alten Artikel wieder als neu gekennzeichnet).

URL mit einem Plugin anpassen

Es gibt verschiedene Plugins, die euch die Änderung der URL in der Datenbank erlauben. Ich nutze hierfür gerne Better Search Replace. Nachdem ihr das Plugin installiert habt, findet ihr unter dem Punkt Werkzeuge den neuen Menüpunkt Better Search Replace. Hier könnt ihr jetzt eingeben, nach welchem String gesucht und womit dieser ersetzt werden soll – im folgenden Screenshot ist das beispielhaft einmal für den Wechsel meiner .de-Domain auf die .com-Domain gemacht.

Unter dem Punkt Tabellen auswählen könnt ihr die Tabellen angeben, in denen die Domain ersetzt werden soll – im Regelfall sollten hier alle ausgewählt werden. Standardmäßig ist der Haken bei Testlauf? gesetzt, wodurch nicht direkt etwas ersetzt sondern nur angezeigt wird, wie viele Vorkommen ersetzt werden würden. Wenn das Ergebnis des Testlaufs sinnvoll aussieht, entfernt den Haken und startet das Suchen und Ersetzen ein weiteres Mal.

Danach solltet ihr mit der Anpassung der Domain fertig sein.

URL mit dem WP-CLI ändern

Wenn ihr das WP-CLI auf eurem Server installiert habt, könnt ihr auf ein Extra-Plugin verzichten und den wp search-replace-Befehl nutzen. Wenn ihr euch in der Shell im Verzeichnis der Installation befindet, kann das beispielsweise so aussehen:

wp search-replace https://florianbrinkmann.de https://florianbrinkmann.com --skip-columns=guid
Code-Sprache: Bash (bash)

Um vorher einen Testlauf zu machen, könnt ihr den Aufruf um die --dry-run-Option erweitern:

wp search-replace https://florianbrinkmann.de https://florianbrinkmann.com --skip-columns=guid --dry-run
Code-Sprache: Bash (bash)

Und wenn ihr alle Tabellen einer Multisite behandeln möchtet, gibt es die --network-Option:

wp search-replace https://florianbrinkmann.de https://florianbrinkmann.com --skip-columns=guid --network
Code-Sprache: Bash (bash)

Wenn ihr die Domain versehentlich falsch geändert habt

Wenn ihr beim Ändern der Domain einen Fehler gemacht habt, kommt ihr wahrscheinlich nicht mehr ins Backend um ihn zu korrigieren. In diesem Fall braucht ihr einen SFTP-Zugang und könnt mit den folgenden zwei Zeilen in der wp-config.php wieder die alte Domain als Site-Adresse einstellen:

define( 'WP_HOME', 'https://florianbrinkmann.de' );
define( 'WP_SITEURL', 'https://florianbrinkmann.de' );
Code-Sprache: PHP (php)

Das ist auch über das WP-CLI möglich – hier könnt ihr entweder direkt die Option in den Einstellungen ändern:

wp option update home https://florianbrinkmann.de
wp option update siteurl https://florianbrinkmann.de
Code-Sprache: Bash (bash)

Oder die Konstante in der wp-config.php (--type=constant sorgt dafür, dass der Eintrag hinzugefügt wird, wenn er noch nicht vorhanden ist):

wp config set WP_HOME https://florianbrinkmann.de --type=constant
wp config set WP_SITEURL https://florianbrinkmann.de --type=constant
Code-Sprache: Bash (bash)

Danach solltet ihr wieder ins Backend kommen und könnt den Fehler korrigieren. Ihr seht: theoretisch könnte auch über diese Wege die Domain geändert werden, ebenso über Einstellungen › Allgemein. In diesen Fällen werden aber nicht die Werte (beziehungsweise beim Ändern in den Einstellungen oder mit wp option update nicht alle Vorkommen) in der Datenbank geändert. Die sauberste Lösung ist meiner Meinung nach daher die Nutzung eines Plugins oder des wp search-replace-Kommandos vom WP-CLI.