WP-CLI ist eine Möglichkeit, WordPress über die Kommandozeile zu bedienen.

Statt eine Aufgabe im WordPress-Backend mit Maus und Menüs auszuführen, gebe ich einen Befehl im Terminal ein. WP-CLI führt diesen Befehl anschließend direkt in meiner WordPress-Installation aus.

Der Name steht für WordPress Command Line Interface – also eine Kommandozeilenschnittstelle für WordPress.

Für mich ist WP-CLI noch Neuland. Bis vor Kurzem hatte ich davon noch nie gehört. Diese Seite dokumentiert deshalb nicht nur Befehle, sondern auch meinen praktischen Einstieg und die Dinge, die ich dabei lerne.

Auf WP-CLI bin ich im Zusammenhang mit meinen WordPress-Projekten gestoßen.

Anfangs wirkte die Arbeit über die Kommandozeile eher ungewohnt. Inzwischen sehe ich darin aber ein Werkzeug, mit dem sich bestimmte Aufgaben schneller und kontrollierter erledigen lassen.

Besonders interessant ist WP-CLI für mich, wenn Arbeiten wiederholt werden müssen oder Änderungen direkt an einer lokalen WordPress-Installation durchgeführt werden sollen.

Mein Ziel ist nicht, möglichst viele WP-CLI-Befehle auswendig zu lernen. Ich möchte verstehen, welche Befehle mir bei meiner praktischen Arbeit wirklich helfen – und genau diese hier dokumentieren.

WP-CLI arbeitet über die Kommandozeile. Ich öffne ein Terminal, wechsle in das Verzeichnis meiner WordPress-Installation und gebe dort einen WP-CLI-Befehl ein.

Das Grundprinzip ist:

Terminal → WordPress-Verzeichnis → WP-CLI-Befehl → Ergebnis

Ein einfacher Befehl sieht zum Beispiel so aus:

wp core version

WP-CLI erkennt anhand der WordPress-Installation, mit welcher Website gearbeitet wird, führt den Befehl aus und zeigt das Ergebnis direkt im Terminal an.

Wichtig für mich: Ein WP-CLI-Befehl ist keine „Zauberei“. Er erledigt lediglich eine bestimmte Aufgabe in WordPress, die ich sonst teilweise über das Backend oder auf anderem Weg durchführen würde.

WP-CLI verwende ich derzeit hauptsächlich in meiner lokalen WordPress-Entwicklungsumgebung unter Windows.

Meine Umgebung:

• Betriebssystem: Windows
• Lokaler Webserver: XAMPP
• Webserver: Apache
• PHP: über XAMPP
• Datenbank: MariaDB / MySQL
• WordPress: lokale Entwicklungsinstallationen
• Terminal: Windows-Kommandozeile bzw. Terminal
• WP-CLI: lokal installiert und über die Kommandozeile aufrufbar

Für die Arbeit mit einer WordPress-Installation wechsle ich im Terminal zunächst in deren Stammverzeichnis.

Beispiel:

cd E:\\xampp\\htdocs\\thecruiserblog

Anschließend kann ich dort die WP-CLI-Befehle für diese WordPress-Installation ausführen.

Meine funktionierende WP-CLI-Installation liegt in einem eigenen Ordner innerhalb meiner XAMPP-Installation:

E:\xampp\wp-cli\

Dort befinden sich die beiden Dateien:

wp-cli.phar
wp.bat

Installierte WP-CLI-Version:

WP-CLI 2.12.0

Für WP-CLI habe ich innerhalb von XAMPP einen eigenen Ordner angelegt:

E:\xampp\wp-cli\

Die Struktur sieht so aus:

E:\xampp\wp-cli\
├── wp-cli.phar
└── wp.bat

Die Datei wp-cli.phar enthält WP-CLI selbst.

Die Datei wp.bat dient unter Windows als Starter. Dadurch kann ich WP-CLI später einfach mit dem Befehl wp aufrufen.

WP-CLI muss auf dem Rechner installiert und so eingerichtet sein, dass der Befehl wp im Terminal aufgerufen werden kann.

In diesem Abschnitt dokumentiere ich meine eigene Installation unter Windows – einschließlich der notwendigen Pfade und Einstellungen.

Wichtig ist mir dabei nicht nur, was eingerichtet werden muss, sondern auch warum. So kann ich die Einrichtung später nachvollziehen oder auf einem anderen Rechner wiederholen.

Mein erster einfacher Informationsbefehl:

wp core version

Der Befehl zeigt die Version der WordPress-Installation an, in deren Verzeichnis ich mich gerade befinde.

Er verändert nichts an der Installation und eignet sich deshalb gut, um den grundsätzlichen Ablauf mit WP-CLI auszuprobieren.

Mit diesem Befehl kann ich prüfen, welche Version von WP-CLI installiert ist:

wp cli version

Der Befehl zeigt die installierte WP-CLI-Version an.

Er verändert nichts an WordPress und eignet sich gut, um zu prüfen, ob WP-CLI grundsätzlich aufgerufen werden kann.

Mit diesem Befehl kann ich die in WordPress hinterlegte Website-Adresse anzeigen:

wp option get siteurl

WP-CLI liest dabei den Wert der WordPress-Option siteurl aus.

Der Befehl verändert nichts an der Installation. Er ist für mich besonders praktisch, um schnell zu kontrollieren, mit welcher WordPress-Installation ich gerade arbeite.

Meine ersten WP-CLI-Befehle sollen vor allem dabei helfen, mich mit der Arbeitsweise vertraut zu machen.

Ich beginne deshalb mit einfachen Befehlen, die Informationen anzeigen und möglichst noch nichts an der WordPress-Installation verändern.

So kann ich ausprobieren, wie WP-CLI reagiert, wie die Ausgabe im Terminal aussieht und wie ein Befehl grundsätzlich aufgebaut ist.

Dieser Bereich wächst mit meiner praktischen Arbeit.

Hier sammle ich nur WP-CLI-Befehle, die ich selbst verwendet habe und deren Zweck ich nachvollziehen kann.

Zu jedem Befehl möchte ich möglichst festhalten:

• den Befehl
• was er bewirkt
• wann ich ihn einsetze
• ein praktisches Beispiel
• wichtige Hinweise oder Risiken

So entsteht nach und nach meine persönliche WP-CLI-Kurzreferenz – statt einer langen Liste von Befehlen, die ich vielleicht nie brauche.

WP-CLI funktioniert nicht immer auf Anhieb. Gerade bei der Einrichtung oder bei Befehlen, die auf weitere Programme zugreifen, können Probleme auftreten.

Hier dokumentiere ich Fehler und Stolpersteine, die mir selbst begegnet sind.

Für jeden Fall möchte ich möglichst festhalten:

• Was wollte ich machen?
• Was ist passiert?
• Welche Fehlermeldung wurde angezeigt?
• Was war die Ursache?
• Wie habe ich das Problem gelöst?

So entsteht mit der Zeit eine persönliche Fehlersammlung, in der ich bei einem ähnlichen Problem schnell nachschauen kann.