12 min. lesen

WP-CLI: Der vollständige Leitfaden zur Verwaltung von WordPress über die Kommandozeile

WP-CLI ist das offizielle Kommandozeilen-Tool zur Verwaltung von WordPress-Installationen direkt von Ihrem Terminal aus, ohne jemals einen Browser zu öffnen. Wenn Sie schon einmal einen Nachmittag damit verbracht haben, sich durch das WordPress-Admin-Dashboard zu klicken, um Plugins für mehrere Websites zu aktualisieren, wissen Sie bereits, warum es dieses Tool gibt.

In diesem Handbuch erfahren Sie alles von der Installation von WP-CLI unter Linux, macOS und Windows bis zur Automatisierung komplexer Wartungsaufgaben mit Skripten und Konfigurationsdateien. Ganz gleich, ob Sie einen einzelnen Blog oder Dutzende von Kundenseiten verwalten, die Beherrschung von WP-CLI wird Ihre Arbeit mit WordPress grundlegend verändern.

Was Sie lernen werden:

Wie Sie WP-CLI auf verschiedenen Betriebssystemen installieren und konfigurieren
Wichtige Befehle für die Verwaltung von Plugins, Themen, Benutzern und Inhalten
Datenbankoperationen einschließlich Export, Import und sicheres Suchen und Ersetzen
Automatisierungstechniken mit Skripten, Aliasen und Cron-Jobs
Bewährte Praktiken zur Vermeidung gängiger Fallstricke bei der Arbeit vom Terminal aus

Was ist WP-CLI? (Kurze Erläuterung zuerst)

WP-CLI steht für WordPress Command Line Interface – ein Open-Source-Tool, mit dem Sie WordPress-Websites vollständig über das Terminal verwalten können. Anstatt sich bei wp-admin anzumelden und durch Menüs zu navigieren, führen Sie Befehle wie wp plugin update --all aus und sehen zu, wie Ihr gesamter Plugin-Stack in Sekundenschnelle aktualisiert wird.

Das Projekt wurde 2011 von Entwicklern ins Leben gerufen, die einen schnelleren Weg zur Verwaltung von WordPress in großem Maßstab suchten. Im Jahr 2017 wurde es unter dem offiziellen Dach von WordPress.org angesiedelt und wird nun von einem engagierten Team von Mitwirkenden, darunter Alain Schlesser und Daniel Bachhuber, gepflegt.

Hier erfahren Sie, was Sie über WP-CLI wissen müssen:

Aktuelle stabile Version: WP-CLI 2.x Serie
WordPress-Kompatibilität: Funktioniert mit WordPress 5.x bis 6.x (und historisch zurück bis 3.7)
PHP-Anforderungen: PHP 7.4+ oder 8.x empfohlen für Sicherheit und Leistung
Befehls-Ökosystem: Über 40 übergeordnete Befehle, die praktisch jede WordPress-Operation abdecken
Hauptnutzer: Entwickler, Agenturen, DevOps-Ingenieure und Power-User, die komplexe oder mehrere Standorte verwalten
Vertrieb: Verfügbar als PHAR-Datei, über Paketmanager oder vorinstalliert auf vielen verwalteten WordPress-Hosts

Die wichtigsten Vorteile der Verwendung von WP-CLI

Sobald Sie verstehen, warum es WP-CLI gibt, ist die Lernkurve viel leichter zu rechtfertigen. In diesem Abschnitt werden die konkreten Vorteile erläutert, die dieses Tool für Sie lohnenswert machen.

Zeitersparnis bei sich wiederholenden Aufgaben
Die Aktualisierung von 20 Plugins über das WordPress-Dashboard bedeutet 20 Seitenaufrufe, 20 Klicks und 20 Fortschrittsbalken. Mit WP-CLI führen Sie wp plugin update --all einmal aus und können dann weitermachen. Für Agenturen, die mehrere Kunden-Websites verwalten, bedeutet dieser Unterschied eine Zeitersparnis von mehreren Stunden pro Woche.

Massen- und automatisierte Operationen
Stellen Sie sich ein Szenario vor, in dem Sie 15 WooCommerce-Shops für den Black Friday vorbereiten. Sie müssen Plugins aktualisieren, Caches leeren und die Datenbankintegrität auf jeder Website überprüfen. Mit WP-CLI können Sie diese gesamte Sequenz skripten und sie für alle Websites in Minuten statt in Stunden ausführen. Zu den wichtigsten Automatisierungsfunktionen gehören:

Aktualisierung aller Plugins für mehrere Installationen mit einem einzigen Skript
Erstellen von Benutzern in großen Mengen mit vordefinierten Rollen
Nächtliche Wartungsarbeiten über cron (Optimierung der Datenbank, Bereinigung von Transienten)
Identische WordPress-Konfigurationen in neuen Umgebungen bereitstellen

Zuverlässigkeit bei browserbasierten Operationen
Bei Browseroperationen kommt es zu HTTP-Zeitüberschreitungen. Große Datenbankimporte schlagen mitten im Prozess fehl. Such- und Ersetzungsoperationen beschädigen serialisierte Daten, wenn sie mit Roh-SQL durchgeführt werden. WP-CLI vermeidet all diese Probleme, da es direkt auf dem Server ohne Timeout-Beschränkungen ausgeführt wird und der Befehl search-replace serialisierte Datenstrukturen korrekt behandelt.

Direkte Kontrolle über die wichtigsten WordPress-Systeme
Von einem Terminal aus können Sie:

Exportieren und Importieren der WordPress-Datenbank
Ändern Sie die Einstellungen von wp-config.php
Überprüfen und Auslösen von wp-cron Ereignissen
Wartungsmodus ein- und ausschalten
Beliebigen PHP-Code im WordPress-Kontext ausführen

Geringere Belastung von wp-admin
Auf ausgelasteten Produktionsservern verbraucht jedes Laden einer Seite des Admin-Dashboards Ressourcen. Die Ausführung von Wartungsarbeiten über WP-CLI entlastet den Webserver, was in Zeiten hoher Auslastung wichtig ist.

WP-CLI Anforderungen und unterstützte Umgebungen

Bevor Sie WP-CLI installieren, müssen Sie sicherstellen, dass Ihr Server oder Ihre lokale Umgebung die grundlegenden Anforderungen erfüllt. Die gute Nachricht ist, dass die meisten modernen WordPress-Konfigurationen die Voraussetzungen bereits erfüllen.

Anforderungen an die PHP-Version:

Minimum: PHP 5.6 (obwohl dies veraltet ist)
Empfohlen: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 oder 8.5 für Sicherheit und Leistung im Jahr 2026

Kompatibilität mit der WordPress-Version:

Historische Unterstützung: WordPress 3.7 und neuere Versionen
Modernes Ziel: WordPress 5.0 bis 6.7+ für aktuelle Projekte

Erwartungen an das Betriebssystem:

Beste Unterstützung: UNIX-ähnliche Systeme (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS)
Windows: Unterstützt über WSL (Windows Subsystem für Linux) oder native PHP-Installation

Zusätzliche Anforderungen:

PHP auf der Kommandozeile verfügbar (die Binärdatei php muss sich in Ihrem PATH befinden)
cURL oder wget zum Herunterladen der Datei wp-cli.phar
SSH-Zugang für entfernte Server (die meisten verwalteten WordPress-Hosting-Angebote enthalten diesen standardmäßig)

Bei vielen beliebten Hostern wie Kinsta, SiteGround und DreamHost ist WP-CLI inzwischen vorinstalliert. Auch WordPress.com enthält WP-CLI für Websites mit aktiviertem SSH-Zugang.

So installieren Sie WP-CLI unter Linux und macOS

Die Standard-Installationsmethode verwendet die offizielle PHAR-Datei (PHP-Archiv). Dieses Verfahren funktioniert auf Ubuntu, Debian, CentOS, Fedora und macOS Terminals.

Schritt 1: Laden Sie die PHAR-Datei herunter
Öffnen Sie Ihr Terminal und laden Sie wp-cli.phar mit curl herunter:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Alternativ können Sie auch wget verwenden:

wget https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Schritt 2: Überprüfen Sie den Download (optional, aber empfohlen)
Vergleichen Sie die SHA-256-Prüfsumme mit dem in der WP-CLI-Dokumentation veröffentlichten offiziellen Wert, um sicherzustellen, dass die Datei während des Downloads nicht manipuliert wurde:

sha256sum wp-cli.phar

Vergleichen Sie die Ausgabe mit der auf der offiziellen WP-CLI-Website aufgeführten Prüfsumme.

Schritt 3: Testen Sie die PHAR-Datei
Bestätigen Sie, dass die php-Datei funktioniert:

php wp-cli.phar --info

Sie sollten eine Ausgabe mit der WP-CLI-Version, der PHP-Version und den Systeminformationen erhalten.

Schritt 4: Machen Sie sie ausführbar und verschieben Sie sie in den PATH
Markieren Sie die Datei als ausführbar und verschieben Sie sie in ein Verzeichnis in Ihrem System-PATH:

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Der Befehl sudo ist normalerweise erforderlich, da /usr/local/bin ein Systemverzeichnis ist. Vermeiden Sie es, WP-CLI als root zu installieren, wenn Sie es hauptsächlich als normaler Benutzer ausführen werden.

Schritt 5: Überprüfen Sie die globale Installation
Bestätigen Sie, dass WP-CLI jetzt global verfügbar ist:

wp --info
wp cli version

Sie sollten eine Ausgabe sehen, die die wp cli-Version, den PHP-Binärspeicherort und die Angaben zum Betriebssystem bestätigt. Jetzt haben Sie WP-CLI installiert und können es verwenden.

Wie Sie WP-CLI unter Windows installieren

Windows-Benutzer haben zwei Möglichkeiten: die Verwendung von Windows Subsystem für Linux (WSL) oder die Einrichtung einer nativen Windows-Installation. WSL bietet eine Linux-ähnlichere Erfahrung und wird im Allgemeinen empfohlen.

Option 1: WSL verwenden (empfohlen)
Aktivieren Sie zunächst WSL unter Windows 10 oder 11:

wsl --install

Installieren Sie Ubuntu aus dem Microsoft Store und starten Sie dann das Ubuntu-Terminal. Führen Sie von dort aus genau die gleichen Schritte zur Linux-Installation aus, wie im vorherigen Abschnitt beschrieben – laden Sie die phar-Datei herunter, machen Sie sie ausführbar und verschieben Sie sie nach /usr/local/bin/wp.

Option 2: Native Windows-Installation
Für eine native Installation müssen Sie PHP für Windows installieren und die ausführbare Datei php in Ihrem Systempfad verfügbar haben.

Downloaden und installieren Sie PHP von der offiziellen PHP für Windows Seite
Fügen Sie das PHP-Verzeichnis zu Ihrer Windows PATH Umgebungsvariable hinzu
Bestätigen Sie, dass PHP funktioniert, indem Sie die Eingabeaufforderung öffnen und Folgendes ausführen php -v

Als nächstes laden Sie die WP-CLI PHAR-Datei herunter:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Windows enthält seit 2018 standardmäßig curl, so dass dies ohne zusätzliche Einrichtung funktionieren sollte. Erstellen Sie einen Ordner für WP-CLI (z.B. C:\wp-cli) und verschieben Sie die heruntergeladene Datei dorthin.

Erstellen Sie dann eine Batch-Wrapper-Datei mit dem Namen wp.bat im selben Ordner:

@echo off
php "C:\wp-cli\wp-cli.phar" %*

Fügen Sie C:\wp-cli zur Umgebungsvariable PATH Ihres Systems hinzu. Öffnen Sie nun ein neues Eingabeaufforderungs- oder PowerShell-Fenster und überprüfen Sie es:

wp --info

Sie sollten die WP-CLI-Version und die Umgebungsdetails sehen, die bestätigen, dass WP-CLI korrekt installiert ist.

Grundlegende WP-CLI-Benutzung und Hilfe erhalten

Wenn Sie WP-CLI installiert haben, müssen Sie das grundlegende Befehlsmuster verstehen, bevor Sie sich mit spezifischen Operationen beschäftigen. Alle WP-CLI-Befehle folgen dieser Struktur:

wp <command> <subcommand> [options]

Die Befehle werden in einem WordPress-Installationsverzeichnis ausgeführt – dem Ordner, der wp-config.php enthält. Wenn Sie sich woanders befinden, können Sie den Pfad mit --path=/var/www/html/mysite angeben.

Überprüfen Sie Ihre Umgebung
Bestätigen Sie zunächst Ihre Einrichtung:

wp --info

Hier werden Ihre WP-CLI-Version, die PHP-Version, der PHP-Binärpfad, das Betriebssystem und andere Umgebungsdetails angezeigt. Um nur die WP-CLI Version zu sehen:

wp cli version

Verfügbare Befehle erkunden
Um alle verfügbaren wp cli-Befehle aufzulisten:

wp help

Für Hilfe zu einem bestimmten Befehl:

wp help plugin
wp help core update

Sie können auch --help an jeden Befehl anhängen:

wp user --help

Die Hilfeausgabe wird in einem Pager angezeigt, der den Unix-Manpages ähnelt. Drücken Sie zum Beenden q.

Erste Befehle zum Ausprobieren:

wp core version – zeigt Ihre WordPress-Version an
wp plugin list – zeigt alle installierten WordPress-Plugins mit deren Status an
wp theme list – zeigt installierte Themen an
wp user list – listet alle Benutzer auf der Website auf

Mit diesen schreibgeschützten Befehlen können Sie Ihre WordPress-Website erkunden, ohne etwas zu ändern. Das ist perfekt, um sich mit der Benutzeroberfläche vertraut zu machen.

Installieren und Konfigurieren von WordPress mit WP-CLI

WP-CLI kann eine komplette Neuinstallation von WordPress schneller durchführen als das traditionelle webbasierte Installationsprogramm. Dies ist besonders wertvoll, wenn Sie Entwicklungsumgebungen einrichten oder neue Websites programmgesteuert einrichten.

Voraussetzungen
Bevor Sie die Installationsbefehle ausführen, müssen Sie eine MySQL- oder MariaDB-Datenbank bereithalten. Für dieses Beispiel gehen wir davon aus, dass Sie eine erstellt haben:

Name der Datenbank: wpsite_db
Datenbank-Benutzer: wpsite_user
Das Passwort: securepassword123
Gastgeber: localhost

Schritt 1: Laden Sie die WordPress-Kerndateien herunter
Navigieren Sie zu Ihrem gewünschten Installationsverzeichnis und laden Sie den WordPress-Kern herunter:

wp core download

Damit holen Sie sich die neueste WordPress-Version. Um eine Version oder ein Gebietsschema anzugeben:

wp core download --version=6.4.2 --locale=fr_FR

Nach der Fertigstellung erhalten Sie eine Bestätigung, dass WordPress erfolgreich heruntergeladen wurde.

Schritt 2: Erzeugen Sie wp-config.php
Erstellen Sie die Konfigurationsdatei mit wp config create:

wp config create --dbname=wpsite_db --dbuser=wpsite_user --dbpass=securepassword123 --dbhost=localhost

Dies erzeugt eine vollständige wp-config.php mit Ihren Datenbankanmeldeinformationen und automatisch generierten Sicherheitssalzen.

Schritt 3: Führen Sie die Installation aus
Installieren Sie nun WordPress mit den Details Ihrer Website:

wp core install --url=https://example.com --title="My New Site" --admin_user=admin --admin_password=strongpassword [email protected]

Sie sehen die Meldung „WordPress erfolgreich installiert“ und Ihre Website ist einsatzbereit.

Multisite-Installation
Für WordPress-Multisite-Netzwerke verwenden Sie die Multisite-Variante. WP-CLI kann Multisite-Installationen mit konfigurieren:

wp core multisite-install --url=https://example.com --title="My Network" --admin_user=admin --admin_password=strongpassword [email protected]

Themes mit WP-CLI verwalten

WP-CLI wickelt alle Theme-Vorgänge ab, ohne dass Sie auf das WordPress-Admin-Dashboard zugreifen müssen. Sie können Themes direkt von Ihrem Terminal aus auflisten, installieren, aktivieren, aktualisieren und löschen.

Auflisten der installierten Themen
So sehen Sie alle derzeit installierten Themen:

wp theme list

Beispielhafte Ausgabe:

Name	Status	Update	Version
twentytwentyfour	aktiv	none	1.0
zweiundzwanzigdreiundzwanzig	inaktiv	none	1.2
astra	inaktiv	verfügbar	4.5.0

Aktivieren eines Themas
Wechseln Sie zu einem anderen Thema:

wp theme activate astra

Dadurch wird das aktive Thema sofort geändert. Das Zurückschalten auf ein Standardthema ist nützlich, um Probleme mit dem Thema zu beheben:

wp theme activate twentytwentyfour

Installieren neuer Themes
Installieren Sie ein Theme aus dem WordPress.org-Repository:

wp theme install astra

Installieren und aktivieren Sie mit einem einzigen Befehl:

wp theme install astra --activate

Themen aktualisieren
Aktualisieren Sie ein bestimmtes Thema:

wp theme update astra

Oder aktualisieren Sie alle Themen auf einmal:

wp theme update --all

Löschen von Themen
Entfernen Sie ein Thema, das Sie nicht mehr benötigen:

wp theme delete twentytwentythree

Plugins mit WP-CLI verwalten

Bei der Verwaltung von Plugins spart WP-CLI am meisten Zeit. Sie können Massenoperationen durchführen, die im Dashboard Dutzende von Klicks erfordern würden.

Plugins auflisten

wp plugin list

Beispielhafte Ausgabe:

Name	Status	Update	Version
woocommerce	aktiv	none	8.5.1
yoast-seo	aktiv	verfügbar	21.0
elementor	inaktiv	none	3.18.0

Installieren von Plugins
Installieren Sie ein Plugin anhand seines Slugs:

wp plugin install woocommerce

Installieren und aktivieren:

wp plugin install yoast-seo --activate

Aktivieren und Deaktivieren
Aktivieren Sie ein Plugin:

wp plugin activate elementor

Deaktivieren Sie ein Plugin (nützlich für die Fehlersuche):

wp plugin deactivate elementor

Deaktivieren Sie alle Plugins auf einmal (Lebensretter bei der Fehlersuche im „White Screen of Death“):

wp plugin deactivate --all

Aktualisieren von Plugins
Aktualisieren Sie ein bestimmtes Plugin:

wp plugin update yoast-seo

Aktualisieren Sie alle Plugins:

wp plugin update --all

Sie können auch bestimmte Plugins von einer Massenaktualisierung ausschließen:

wp plugin update --all --exclude=woocommerce

Aktualisieren und Reparieren des WordPress-Kerns

WordPress auf dem neuesten Stand zu halten, ist entscheidend für die Sicherheit. WP-CLI macht diesen Prozess transparent und kontrollierbar.

Prüfen auf Updates

wp core check-update

WordPress aktualisieren
Aktualisieren Sie auf die neueste Version:

wp core update

Nach einem Core-Update ist es sinnvoll, das Datenbankschema zu aktualisieren:

wp core update-db

Überprüfen von Prüfsummen
Wenn Sie den Verdacht haben, dass Ihre Website gehackt wurde, können Sie überprüfen, ob die Kerndateien nicht verändert wurden:

wp core verify-checksums

Diese vergleicht Ihre Dateien mit den Prüfsummen des offiziellen WordPress-Repositorys.

Neuinstallation von Core
Wenn Dateien beschädigt sind, können Sie eine Neuinstallation erzwingen, ohne dass Ihr Inhalt beeinträchtigt wird:

wp core download --force --skip-content

Inhalte, Benutzer und Datenbank verwalten

Mit WP-CLI können Sie direkt mit den Daten Ihrer Website interagieren.

Benutzerverwaltung
Benutzer auflisten:

wp user list

Erstellen Sie einen neuen Administrator:

wp user create newadmin [email protected] --role=administrator --user_pass=securepass123

Aktualisieren Sie ein Benutzerpasswort:

wp user update 1 --user_pass=newpassword

Löschen Sie einen Benutzer und weisen Sie seine Inhalte neu zu:

wp user delete 5 --reassign=1

Datenbankoperationen
Exportieren Sie die Datenbank in eine Datei:

wp db export backup.sql

Importieren Sie eine Datenbank aus einer Datei:

wp db import backup.sql

Optimieren Sie die Datenbank:

wp db optimize

Öffnen Sie eine MySQL-Konsole, die direkt mit Ihrer WordPress-Datenbank verbunden ist:

wp db cli

Suchen und Ersetzen (Der richtige Weg)

Das manuelle Verschieben einer WordPress-Website auf eine neue Domain ist riskant, da die Daten in der Datenbank oft serialisiert sind. Eine einfache SQL-Suche und -Ersetzung kann Widgets und Theme-Optionen zerstören. WP-CLI behandelt die Serialisierung korrekt.

Standard Suchen-Ersetzen

wp search-replace 'http://old-domain.com' 'https://new-domain.com'

Trockenlauf (Vorschau)
Prüfen Sie immer, was sich ändern wird, bevor Sie den Befehl ausführen:

wp search-replace 'http://old-domain.com' 'https://new-domain.com' --dry-run

Exportieren mit Ersetzung
Sie können eine Datenbank mit den in der Datei vorgenommenen Ersetzungen exportieren, wobei die Live-Datenbank unberührt bleibt:

wp search-replace 'old.com' 'new.com' --export=migrated-db.sql

Erweiterte Wartung: Cron und Objekt-Cache

Verwalten von Cron-Jobs
Sehen Sie sich geplante Ereignisse an:

wp cron event list

Führen Sie alle fälligen Cron-Ereignisse sofort aus:

wp cron event run --due-now

Verwalten von Transienten und Cache
Löschen Sie den Objekt-Cache:

wp cache flush

Löschen Sie alle abgelaufenen Transienten:

wp transient delete --expired

Aufgaben mit Skripten automatisieren

Sie können WP-CLI-Befehle in Bash-Skripten für die automatische Wartung kombinieren.

Beispiel: Wöchentliches Wartungsskript
Erstellen Sie eine Datei namens maintain.sh:

#!/bin/bash
# Update everything
wp core update
wp core update-db
wp plugin update --all
wp theme update --all

# Cleanup
wp transient delete --expired
wp cache flush
wp db optimize

echo "Maintenance complete."

Machen Sie es ausführbar (chmod +x maintain.sh) und führen Sie es aus, um die komplette Website-Wartung in Sekundenschnelle durchzuführen.

WP-CLI aus der Ferne über SSH verwenden

Sie müssen sich nicht am Server anmelden, um Befehle auszuführen, wenn Sie Aliasnamen konfigurieren.

In Ihrer lokalen Datei wp-cli.yml:

@prod:
  ssh: [email protected]/var/www/html
@dev:
  ssh: [email protected]/var/www/html

Jetzt können Sie von Ihrem lokalen Rechner aus Befehle auf dem Remote-Server ausführen:

wp @prod plugin list
wp @dev core version

Bewährte Praktiken

Immer sichern: Bevor Sie Massenaktualisierungen oder Befehle zum Suchen und Ersetzen ausführen, führen Sie wp db export aus.
Verwenden Sie Dry Run: Verwenden Sie zum Suchen und Ersetzen immer zuerst --dry-run.
Führen Sie nicht als Root aus: WP-CLI warnt Sie, wenn Sie als Root ausgeführt werden. Es ist sicherer, als Webserver-Benutzer (z.B. www-data) oder als Ihr spezielles Benutzerkonto zu arbeiten.
Testen Sie auf Staging: Verwenden Sie WP-CLI, um Ihre Produktionsseite in die Staging-Umgebung zu klonen, Ihre Update-Skripte dort zu testen und sie dann auf die Produktionsseite anzuwenden.

Fazit

WP-CLI verwandelt die WordPress-Verwaltung von einer Reihe von Klicks in rationalisierte, skriptfähige Vorgänge. Der Beginn mit einfachen Befehlen wie der Überprüfung von Versionen und der Auflistung von Plugins bildet die Grundlage für eine fortgeschrittene Automatisierung. Wenn Sie WP-CLI noch heute in Ihre Arbeitsabläufe integrieren, werden Sie unzählige Stunden bei Ihren WordPress-Projekten sparen.