WP-CLI nutzen: WordPress über die Kommandozeile (SSH) verwalten

Auf einen Blick

Mit WP-CLI (WordPress Command Line Interface) steuerst du deine WordPress-Websites blitzschnell über die Kommandozeile, ohne dich im WordPress-Dashboard anzumelden. Dieser Artikel zeigt dir, wie du die vorinstallierte WP-CLI-Umgebung bei HostPress aktivierst, eine SSH-Verbindung aufbaust und wichtige Administrations-Befehle ausführst.

Voraussetzungen

Bevor du WP-CLI auf deinem HostPress-Server aktiv nutzen kannst, müssen folgende Voraussetzungen erfüllt sein:

• Ein aktiver SSH-Zugang zu deinem HostPress-Hosting-Tarif.
• Die Freischaltung von PHP in deiner CHROOT-Umgebung durch den HostPress-Support.
• Ein Terminal-Programm auf deinem Computer (z. B. Terminal unter macOS/Linux oder PowerShell/Eingabeaufforderung unter Windows).

Schritt-für-Schritt-Anleitung

Schritt 1: CHROOT-Umgebung durch den Support freischalten lassen

Aus Sicherheitsgründen ist PHP in der Standard-CHROOT-Umgebung isoliert. Damit WP-CLI ausgeführt werden kann, muss unser Support-Team die Umgebung einmalig für dich anpassen.

1. Logge dich in dein HostPress-Kundencenter unter my.hostpress.de ein.
2. Klicke im Menü auf Support > Tickets und erstelle ein neues Ticket mit dem Betreff „WP-CLI CHROOT Freischaltung“.
3. Sende uns die Nachricht: „Bitte gebt PHP in der CHROOT-Umgebung für meine WordPress-Installation frei, damit ich WP-CLI nutzen kann.“
4. Sobald unser Support-Team die Freischaltung bestätigt hat, kannst du mit Schritt 2 fortfahren.

Schritt 2: Per SSH auf den Server einloggen

Nach der Freischaltung verbindest du dich über die Konsole deines Computers mit deinem HostPress-Server.

1. Öffne das Terminal (macOS/Linux) oder die PowerShell (Windows) auf deinem Computer.
2. Gib den folgenden SSH-Verbindungsbefehl ein (ersetze die Platzhalter durch deine echten SSH-Zugangsdaten aus dem Kundencenter):Bashssh ssh-benutzername@deine-server-ip
3. Bestätige die Verbindung und gib dein SSH-Passwort ein.
4. Navigiere in das Hauptverzeichnis deiner WordPress-Installation (in der Regel der Ordner httpdocs), indem du folgenden Befehl ausführst:Bashcd httpdocs

Schritt 3: WP-CLI-Funktionalität prüfen

Da WP-CLI bei HostPress bereits serverseitig vorinstalliert ist, musst du keine manuelle Installation durchführen.

1. Führe im WordPress-Verzeichnis (httpdocs) folgenden Befehl aus:Bashwp --info
2. Wenn die Umgebung korrekt eingerichtet ist, gibt das Terminal nun detaillierte Systeminformationen zur WP-CLI-Version und der verwendeten PHP-Version aus.

Wichtige WP-CLI-Befehle im Alltag

Verwende diese Befehle direkt in der SSH-Konsole innerhalb deines WordPress-Hauptverzeichnisses (httpdocs).

WordPress-Plugins verwalten

• Alle Plugins gleichzeitig aktualisieren:Bashwp plugin update --all
• Ein bestimmtes Plugin deaktivieren (z. B. bei Fehlern):Bashwp plugin deactivate plugin-ordnername
• Alle Plugins auf einmal deaktivieren:Bashwp plugin deactivate --all

WordPress-Core und Themes aktualisieren

• WordPress-Core-System aktualisieren:Bashwp core update
• Alle installierten Themes auf einmal aktualisieren:Bashwp theme update --all

Benutzerverwaltung und Passwörter

• Einen neuen Administrator-Benutzer erstellen:Bashwp user create neueradmin email@domain.com --role=administrator --user_pass=SicheresPasswort123
• Das Passwort eines bestehenden Benutzers zurücksetzen:Bashwp user update admin-benutzername --user_pass=NeuesSicheresPasswort123
• Eine Liste aller registrierten Benutzer abrufen:Bashwp user list

Datenbank verwalten und optimieren

• Ein schnelles Datenbank-Backup exportieren:Bashwp db export backup.sql
• Die WordPress-Datenbank optimieren und bereinigen:Bashwp db optimize

Profi-Tipps & Fehlerbehebung (Troubleshooting)

1. Problem: Fehler „Command ‚wp‘ not found“ oder PHP-Fehler im Terminal

• Ursache: Entweder wurde die PHP-Freigabe in der CHROOT-Umgebung vom Support für diesen spezifischen SSH-Nutzer noch nicht aktiviert, oder du befindest dich im falschen Server-Verzeichnis.
• Lösung für den Fin Bot / User: Überprüfe mit dem Befehl pwd, ob du dich wirklich im WordPress-Ordner (httpdocs) befindest. Falls ja, kontaktiere den HostPress-Support über das Kundencenter, um die CHROOT-Umgebung für PHP prüfen und aktivieren zu lassen.

2. Problem: Webseite zeigt nach einem Update einen „White Screen of Death“ (WSoD)

• Ursache: Ein aktualisiertes Plugin oder Theme ist inkompatibel und blockiert das PHP-Rendering der Website.
• Lösung für den Fin Bot / User: Deaktiviere sofort alle Plugins über die Konsole mit dem Befehl wp plugin deactivate --all. Wenn die Seite danach wieder erreichbar ist, aktiviere die Plugins einzeln im WordPress-Dashboard oder via wp plugin activate plugin-ordnername, um die Fehlerquelle zu isolieren.

3. Problem: Syntax-Unsicherheiten bei erweiterten Befehlen

• Lösung: WP-CLI verfügt über eine integrierte Hilfefunktion. Wenn du nicht weißt, welche Parameter ein Befehl erlaubt, tippe folgenden Befehl ein, um das Handbuch direkt im Terminal zu öffnen:Bashwp help plugin

4. Problem: WP-CLI bricht plötzlich mit „Failed opening required … wpt-wp-cli.php“ ab

• Symptom: wp-Befehle, die bisher funktioniert haben, brechen plötzlich mit einer Meldung wie Failed opening required '/usr/local/psa/admin/plib/modules/wp-toolkit/vendor/wp-cli/wpt-wp-cli.php' ab. Cronjobs, die WP-CLI nutzen, schlagen dann bei jedem Lauf fehl.
• Ursache: Das vorinstallierte WP-CLI wird über das WP Toolkit bereitgestellt. Bei einem Update des WP Toolkit wird dessen Verzeichnis neu angelegt. Bis die Verbindung zu deiner abgesicherten SSH-Umgebung (CageFS) neu geladen ist, findet wp die benötigte Datei nicht. Mit deiner Website oder deiner PHP-Version hat das nichts zu tun.
• Lösung: In der Regel stellt unser System die Verbindung nach einem Toolkit-Update innerhalb weniger Minuten automatisch wieder her. Warte kurz und teste dann mit wp --info. Besteht der Fehler länger als etwa 15 Minuten, kontaktiere unseren Support mit der genauen Fehlermeldung und dem Zeitpunkt des ersten Auftretens.

Optional: WP-CLI unabhängig vom WP Toolkit betreiben

Wenn du WP-CLI für wichtige Cronjobs nutzt und von Toolkit-Updates unabhängig sein möchtest, kannst du eine eigene WP-CLI-Version in deinem Hosting-Verzeichnis verwenden:

1. Verbinde dich per SSH und wechsle in dein Home-Verzeichnis.
2. Lade die offizielle WP-CLI-Datei herunter:
   curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
3. Prüfe, ob sie funktioniert:
   php wp-cli.phar --info
4. Ersetze in deinen Cronjobs den Aufruf wp durch den vollständigen Pfad, z. B. php ~/wp-cli.phar --path=httpdocs plugin list.
5. Aktualisiere deine eigene WP-CLI-Version gelegentlich mit php ~/wp-cli.phar cli update.

Hinweis: Das ist optional. Für die meisten Kunden reicht das vorinstallierte WP-CLI völlig aus.

5. Problem: Eigene PHP-Skripte per SSH brechen mit „Rate limit exceeded“ ab

• Ursache: Startest du ein eigenes PHP-Skript mit php skript.php, das WordPress über wp-load.php lädt, behandelt das Plugin „Imunify Security“ jeden Aufruf wie eine Web-Anfrage ohne IP-Adresse und Browserkennung. Nach wenigen Aufrufen kurz hintereinander greift deshalb das Rate Limit, obwohl deine Ressourcen weit unter den Limits liegen.
• Lösung: Starte das Skript über WP-CLI mit wp eval-file /pfad/zu/skript.php. Das require auf wp-load.php entfällt, WP-CLI lädt WordPress selbst. Aufrufe über WP-CLI lässt das Plugin durch. Varianten mit bestimmter PHP-Version und Hinweise für automatisierte SSH-Aufrufe findest du im Artikel Imunify Security in deinem WordPress.

Weiterführende Ressourcen

• Ausführliches Tutorial: Du möchtest noch tiefer einsteigen, mehr über die Automatisierung von Skripten erfahren oder Best Practices kennenlernen? In unserem WP-CLI Blog-Artikel erklären wir dir alle Funktionen und Hintergründe im Detail.

Fazit & Support-Hinweis

WP-CLI ist das effizienteste Werkzeug zur Wartung deiner WordPress-Websites direkt auf Serverebene. Es spart Zeit und rettet deine Seite, selbst wenn das visuelle WordPress-Backend nicht mehr erreichbar ist.

Solltest du Probleme beim SSH-Verbindungsaufbau haben oder die Freischaltung der CHROOT-Umgebung benötigen, erstelle einfach ein Ticket in deinem Kundencenter unter my.hostpress.de oder kontaktiere uns per E-Mail unter support@hostpress.de. Unser Support-Team hilft dir gerne weiter.