WP-CLI

Zuletzt aktualisiert: 13. September 2024

WP-CLI (WordPress Command Line Interface) ist ein leistungsstarkes Tool, mit dem du eine WordPress-Installation direkt über die Kommandozeile oder das Terminal verwalten kannst. Anstatt das Standard-WordPress-Dashboard zu verwenden, kannst du Befehle ausführen, um Aufgaben wie die Aktualisierung von Plugins, die Verwaltung von Themes und die Konfiguration von Einstellungen direkt von deinem Terminal aus zu erledigen.

Die Verwendung von WP-CLI bietet eine Reihe von Vorteilen, darunter:

Geschwindigkeit: Das Ausführen von Aufgaben über die Kommandozeile ist oft schneller als das Navigieren durch die WordPress-Admin-Oberfläche, insbesondere bei sich wiederholenden Aufgaben.
Automatisierung: WP-CLI kann in Skripte für automatisierte Arbeitsabläufe integriert werden.
Fernverwaltung: WP-CLI ermöglicht es dir, WordPress-Websites aus der Ferne zu verwalten.
Flexibilität: Die Möglichkeit, Befehle und Skripte auszuführen, bietet ein hohes Maß an Kontrolle und Anpassungsmöglichkeiten.

Zugang zu WP-CLI auf Kinsta

WP-CLI v2 ist standardmäßig auf allen unseren Servern installiert. Um auf WP-CLI zuzugreifen, musst du dich per SSH mit deinem Server verbinden und zum Dokumentenstamm deiner Website navigieren. Kinsta bietet SSH-Zugang mit allen unseren Managed WordPress Hosting-Paketen.

1. Verbindung zu deinem Server mit SSH

Die einfachste Methode für die Verbindung über SSH ist die Verwendung eines Benutzernamens und eines Passworts. Die Schritte für die Verbindung hängen von deinem Betriebssystem ab.

Windows

Windows-Nutzer benötigen einen Terminal-Client, um sich mit SSH zu verbinden. Wir empfehlen, den kostenlosen PuTTY-Client mit dem .msi-Installationsprogramm herunterzuladen.

Starte PuTTY und gib deine Host-IP-Adresse und die eindeutige Portnummer ein (beide findest du unter MyKinsta > Websites > seitenname > Info > SFTP/SSH). Klicke dann auf Öffnen.
Wenn du zum ersten Mal eine Verbindung herstellst, wirst du wahrscheinlich eine rsa2-Schlüsselabfrage sehen. Klicke auf Ja, damit du dem Host in Zukunft vertraust.
Gib auf dem Terminal-Bildschirm deinen Kinsta-Benutzernamen ein (zu finden unter MyKinsta > Websites > seitenname > Info > SFTP/SSH) und drücke die Eingabetaste.
Gib dein Kinsta-Passwort ein (zu finden unter MyKinsta > Websites > seitenname > Info > SFTP/SSH) und drücke erneut die Eingabetaste.

Du bist jetzt über SSH mit deiner WordPress-Website verbunden.

Mac/Linux

Öffne ein neues Terminal über Anwendungen > Dienstprogramme > Terminal.
In MyKinsta navigierst du zu Websites > seitenname > Info > SFTP/SSH und klicke beim SSH-Terminalbefehl auf In die Zwischenablage kopieren.
Füge den SSH-Terminalbefehl in das Terminal ein und drücke Enter.
Gib dein Kinsta-Passwort ein (zu finden unter MyKinsta > Websites > seitenname > Info > SFTP/SSH) und drücke erneut die Eingabetaste.

Du bist jetzt über SSH mit deiner WordPress-Website verbunden.

2. Navigiere zum Dokumentenstamm deiner Website

Um WP-CLI-Befehle auszuführen, musst du zunächst zum Dokumentenstamm deiner Website navigieren. Dort befinden sich deine WordPress-Dateien (wie wp-config.php, wp-content, wp-admin und wp-includes). Um auf Kinsta zum Dokumentenstamm deiner Website zu navigieren, gibst du den folgenden Befehl ein:

cd public

Du kannst jetzt WP-CLI-Befehle für deine auf Kinsta gehostete WordPress-Installation verwenden. Eine vollständige Liste der verfügbaren WP-CLI-Befehle findest du in der WordPress-Entwicklerdokumentation.

Nützliche WP-CLI-Befehle

Nachfolgend findest du eine Liste von WP-CLI-Befehlen, die du vielleicht hilfreich findest. Eine vollständige Liste der verfügbaren WP-CLI-Befehle, einschließlich der globalen Parameter und Optionen, findest du in der WordPress-Entwicklerdokumentation.

Nützliche Optionen

Im Folgenden findest du eine Liste nützlicher Optionen, die du an das Ende deiner Befehle anhängen kannst:

--skip-themes: Dies verhindert, dass WordPress-Themes geladen werden, wenn du einen WP-CLI-Befehl ausführst. Das ist nützlich, wenn es in einem der Themes ein Problem gibt, das Konflikte mit WP-CLI-Befehlen verursacht.
--skip-plugins: Dies verhindert, dass WordPress-Plugins geladen werden, wenn du einen WP-CLI-Befehl ausführst. Dies ist nützlich, wenn ein Problem in einem der Plugins besteht, das Konflikte mit WP-CLI-Befehlen verursacht.
--all: Hiermit wird ein Befehl auf alle relevanten Elemente angewendet. Zum Beispiel, wenn du alle Plugins oder Benutzer aktualisieren willst.
--dry-run: Damit kannst du die Ausführung eines Befehls simulieren, ohne tatsächliche Änderungen vorzunehmen. Sie zeigt dir, was passieren würde, wenn der Befehl ausgeführt würde, aber sie führt keine der Aktionen aus. Zum Beispiel, wenn du Suchen und Ersetzen ausführst, alle Plugins aktualisierst oder Beiträge massenhaft löschst.
--format=<format>: Legt das Ausgabeformat beim Exportieren von Daten fest. Wenn du zum Beispiel wp plugin list oder wp user list ausführst, möchtest du die Daten vielleicht im Format table, json oder csv ausgeben.

Plugins

Eine Liste der Plugins anzeigen

Mit dem folgenden Befehl kannst du dir eine Liste der installierten Plugins anzeigen lassen:

wp plugin list

Aktiviere ein Plugin

Um ein Plugin zu aktivieren, verwende den folgenden Befehl und ersetze $plugin durch den Namen des Plugins aus wp plugin list.

wp plugin activate $plugin

Deaktivieren eines Plugins

Um ein Plugin zu deaktivieren, ersetze $plugin durch den Namen des Plugins aus dem wp plugin list.

wp plugin deactivate $plugin

Ein bestimmtes Plugin aktualisieren

Um ein Plugin zu aktualisieren, ersetze $plugin durch den Namen des Plugins aus dem wp plugin list.

wp plugin update $plugin

Alle Plugins aktualisieren

wp plugin update --all

Ein Plugin zurücksetzen

Wenn du ein Plugin aktualisierst, und dann etwas auf deiner Seite nicht mehr funktioniert, kannst du es zurücksetzen, indem du eine bestimmte Version mit dem folgenden Befehl installierst. Ersetze dabei $plugin durch den Namen des Plugins aus wp plugin list und $version durch die gewünschte Versionsnummer.

wp plugin update $plugin --version=$version

URLs

Festlegen der Home-URL

Um die URL für deine Startseite festzulegen, verwende den folgenden Befehl und ersetze $URL durch die gewünschte URL.

wp option update home '$URL'

Festlegen der URL der Website

Um die URL deiner Website festzulegen, verwende den folgenden Befehl und ersetze $URL durch die gewünschte URL.

wp option update siteurl '$URL'

Benutzer

Alle WordPress-Benutzer auflisten

Mit dem folgenden Befehl kannst du dir eine Liste aller WordPress-Benutzer anzeigen lassen:

wp user list

Einen neuen Benutzer erstellen

Um einen neuen Benutzer zu erstellen, verwende den folgenden Befehl. Ersetze $username und $emailaddress durch die Anmeldedaten des Benutzers und $role durch die Rolle, die du dem neuen Benutzer zuweisen möchtest, z.B. Administrator.

wp user create $username $emailaddress -–role=$role

Das Passwort eines Benutzers zurücksetzen

Um das Passwort eines Benutzers zurückzusetzen, gibst du den folgenden Befehl ein und ersetzt $username durch den gewünschten Benutzernamen aus wp user list.

wp user reset-password $username

Benutzerdaten aktualisieren

Um einen Benutzer zu aktualisieren, verwende den folgenden Befehl und ersetze $user durch den gewünschten Benutzernamen aus wp user list, $field durch das Feld, das du aktualisieren möchtest, und $value durch die neuen Daten, die du eingeben möchtest.

wp user update $user -—$field=$value

Cache

Um die unten aufgeführten Befehle zum Löschen des Caches zu verwenden, muss das Kinsta Must Use (MU) Plugin auf der Website installiert sein.

Alle Caches löschen

Um den gesamten Cache zu löschen, einschließlich Site-Cache, Edge-Cache, CDN-Cache und Redis-Cache, verwende den folgenden Befehl:

wp kinsta cache purge --all

Full-Page-Cache und Edge-Cache löschen

Um den Full-Page-Cache und den Edge-Cache zu löschen, verwende den folgenden Befehl:

wp kinsta cache purge

Site-Cache löschen, ohne den Edge-Cache zu löschen

Um nur den Site-Cache zu löschen, verwende den folgenden Befehl:

wp kinsta cache purge --site

Lösche den CDN-Cache

Um nur den CDN-Cache zu löschen, verwende den folgenden Befehl:

wp kinsta cache purge --cdn

Redis-Cache löschen

Um nur den Redis-Cache zu löschen, verwende den folgenden Befehl:

wp kinsta cache purge --object

Objekt-Cache leeren

Flush den Objekt-Cache deiner Website mit dem folgenden Befehl:

wp cache flush

Dies kann vorübergehend zu einer leichten Verlängerung der Ladezeiten führen, da der Cache neu aufgebaut wird.

Suchen und Ersetzen

Wenn du Suchen und Ersetzen auf deiner WordPress-Website durchführst, empfehlen wir dir, ein Backup zu erstellen und die Option --dry-run zu verwenden, um zu sehen, was ersetzt werden soll, bevor du den Befehl ausführst.

Alte Domain durch neue Domain ersetzen

Um eine alte URL durch eine neue URL zu ersetzen, verwende den folgenden Befehl. Ersetze dabei $old-domain durch die URL, die du ersetzen willst, und $new-domain durch die URL, die du durch die neue ersetzen willst:

wp search-replace '$old-domain' '$new-domain' --skip-columns=guid

--skip-columns=guid wird empfohlen, um zu vermeiden, dass URLs, die als eindeutige Bezeichner in der Spalte guid in der Datenbank gespeichert sind, versehentlich geändert werden, was zu einem Bruch von Post-URLs führen könnte. Dieser Befehl kann auch verwendet werden, um E-Mail-Adressdomänen zu ersetzen.

HTTP durch HTTPS ersetzen

Um deine URLs von HTTP auf HTTPS zu aktualisieren, verwende den folgenden Befehl:

wp search-replace 'http://' 'https://' --skip-columns=guid

--skip-columns=guid wird empfohlen, um zu vermeiden, dass URLs, die als eindeutige Bezeichner in der Spalte guid der Datenbank gespeichert sind, versehentlich geändert werden, was zu Problemen mit Medienanhängen führen könnte.

Fehlersuche

Wenn du Probleme beim Ausführen von Befehlen in WP-CLI hast, kann das an einem Theme oder Plugin liegen, das einen schwerwiegenden Fehler aufweist. Du kannst deinem WP-CLI-Befehl Folgendes hinzufügen, um das Laden von Themes und Plugins zu überspringen:

--skip-themes --skip-plugins

Um zum Beispiel eine Liste der Benutzer zu erhalten und die Themes und Plugins zu überspringen, kannst du Folgendes ausführen:

wp user list --skip-themes --skip-plugins

Wenn du bestimmte Plugins auslassen willst, kannst du Folgendes verwenden: Ersetze $plugin durch den Namen des Plugins und trenne die einzelnen Plugins mit einem Komma:

--skip-plugins=$plugin,$plugin

Zum Beispiel:

wp user list --skip-plugins=wordpress-seo,wordfence