WP-CLI: WordPress auf der Kommandozeile

WP-CLI ist die offizielle Kommandozeile für WordPress: Plugins aktivieren, Core aktualisieren, Caches leeren oder URLs in der Datenbank ersetzen — per SSH, ohne Backend-Login. Unverzichtbar, wenn das Backend gerade nicht erreichbar ist.

Voraussetzungen

• SSH-Zugang zum Server — siehe SSH-Zugang einrichten.
• Den Pfad deiner WordPress-Installation (das Verzeichnis mit der wp-config.php).

Schritt für Schritt

1. Verbinde dich per SSH und wechsle in den Document Root: cd ~/httpdocs (cPanel: cd ~/public_html; anderer Ordner → Document Root ändern).
2. Prüfe, ob WP-CLI verfügbar ist: wp --version.
3. Fehlt der Befehl, lade WP-CLI als Nutzer herunter: curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar und rufe es mit php wp-cli.phar <befehl> auf.
4. Verschaff dir einen Überblick: wp core version, wp plugin list, wp theme list.
5. Führ die eigentliche Aufgabe aus — z. B. wp plugin update --all oder wp cache flush.

search-replace erst als Probelauf

wp search-replace 'alt.beispiel.de' 'neu.beispiel.de' schreibt direkt in die Datenbank. Häng beim ersten Aufruf immer --dry-run an und prüfe die angekündigten Änderungen, bevor du ohne Probelauf wiederholst.

Auf der Shell zählt die CLI-PHP-Version, nicht die Panel-Einstellung der Domain. Meldet WP-CLI eine zu alte PHP-Version, ruf es gezielt mit dem passenden Binary auf — die Wege dafür zeigt PHP-Version auf der Shell korrekt nutzen.

Wenn etwas schiefläuft

wp: command not found

WP-CLI ist auf diesem Server nicht global installiert.

Lösung: Das Phar wie in Schritt 3 herunterladen und mit php wp-cli.phar … aufrufen. Für Komfort einen Alias setzen: alias wp='php ~/wp-cli.phar'.

Error establishing a database connection

WP-CLI liest die Zugangsdaten aus der wp-config.php des aktuellen Verzeichnisses — außerhalb der Installation findet es keine.

Lösung: Ins Installations-Verzeichnis wechseln oder den Pfad explizit mitgeben: wp --path=/pfad/zur/installation <befehl>.

This does not seem to be a WordPress installation

Der aktuelle Ordner enthält keine vollständige WordPress-Struktur — häufig, weil der Document Root auf einen Unterordner zeigt.

Lösung: Mit ls prüfen, wo wp-config.php und wp-includes/ liegen, und dorthin wechseln.

Verwandte Artikel

• SSH-Zugang einrichten — die Voraussetzung für alles hier.
• PHP-Version auf der Shell korrekt nutzen — damit WP-CLI mit der richtigen PHP-Version läuft.
• WP-Toolkit: WordPress im Panel verwalten — die Oberflächen-Alternative für Standard-Aufgaben.

Du kommst nicht weiter?

Ein WP-CLI-Befehl bricht mit einer unklaren Meldung ab? Ticket im Kundencenter öffnen — schick den Befehl und die vollständige Ausgabe mit, dann schauen wir gemeinsam drauf.