WordPress
WP-CLI auf Ihrer WordPress-Website verwenden
KPanel includes a WP-CLI console that runs commands against your WordPress site from the browser, with no SSH client and no server login. This guide covers where to find it, exactly which commands…
KPanel beinhaltet eine WP-CLI-Konsole, die Befehle gegen Ihre WordPress-Website aus dem Browser ausführt, ohne SSH-Client und ohne Server-Login. Dieses Handbuch behandelt, wo Sie diese finden, welche Befehle genau zulässig sind und warum, die in den Bildschirm integrierten Verknüpfungen und was Sie tun, wenn Sie etwas benötigen, das die Konsole nicht ausführt.
Öffnen der Konsole
- Melden Sie sich bei KPanel an und klicken Sie links in der Seitenleiste auf Websites.
- Klicken Sie auf Ihre WordPress-Website.
- Öffnen Sie die Registerkarte WordPress und dann den Bereich Console.
Die Eingabe beginnt bereits mit einer festen wp, also geben Sie nur ein, was danach kommt. plugin list, nicht wp plugin list. Drücken Sie Enter oder klicken Sie auf Run.
Console ist einer der Bereiche, die in verwalteten Plänen angezeigt werden. Bei anderen Plänen endet die Registerkartenleiste stattdessen mit einem Link +8 on Managed. Jede hier beschriebene Aktion, die kein reiner Befehl ist, hat eine entsprechende Schaltfläche an anderer Stelle in KPanel, sodass nichts unerreichbar ist: Die Konsole ist eine schnellere Möglichkeit, dieselbe Engine zu erreichen.
Befehle werden als Systembenutzer Ihrer Website in Ihrem Website-Verzeichnis ausgeführt. Sie können keine andere Website sehen oder berühren.
Was die Konsole ausführt und nicht ausführt
Die Konsole verwendet eine Zulassungsliste. Nur die unten aufgeführten Befehlspräfixe werden akzeptiert, und alles andere wird mit einer Nachricht, die den Befehl benennt, den sie ablehnt, abgelehnt, bevor es den Server erreicht.
| Bereich | Zulässig |
|---|---|
| Core | core version, core check-update, core update, core is-installed, core verify-checksums |
| Plugins | plugin list, plugin update, plugin install, plugin activate, plugin deactivate, plugin status, plugin get, plugin delete, plugin verify-checksums |
| Themes | theme list, theme update, theme install, theme activate, theme status, theme get, theme delete |
| Users | user list, user get, user create, user update, user set-role, user delete, user reset-password, user add-cap, user remove-cap, user generate |
| Database | db size, db tables, db optimize, db repair, db check |
| Cache und Transients | cache flush, cache get, cache set, cache add, cache delete, transient get, transient set, transient delete |
| Rewrite-Regeln | rewrite flush, rewrite list, rewrite structure |
| Cron | cron event list, cron event run, cron schedule list |
| Config | config get, config list, config has, config shuffle-salts |
| Wartungsmodus | maintenance-mode activate, maintenance-mode deactivate, maintenance-mode status |
| Schreibgeschützte Überprüfung | option get, option list, post list, post get, comment list, comment get |
| Medien und Sprache | media regenerate, language core install, language core update |
| Suchen und Ersetzen | search-replace |
Die absichtlichen Ausschlüsse sind wichtiger als die Einschlüsse:
evalundshellsind blockiert. Beliebiger PHP-Code und beliebige Shell-Befehle würden die Konsole einer Root-Eingabeaufforderung in einem Browser-Tab gleichsetzen.db import,db export,db drop,db queryunddb resetsind blockiert. Import und Reset zerstören eine Datenbank ohne Bestätigungsschritt;db queryist eine unbeschränkte SQL-Eingabeaufforderung. Verwenden Sie stattdessen phpMyAdmin: Accessing Your Database With phpMyAdmin.config setundconfig deletesind blockiert. Ein fehlerhafterwp-config.php-Schreibvorgang nimmt die Website offline. Lesen Sie die Werte hier, ändern Sie sie über den Dateimanager.option updateundoption deletesind blockiert. Optionen blind zu bearbeiten ist eine häufige Methode, eine Website über alle Grenzen hinaus zu beschädigen.
Die Konsole erstellt für Sie keine Sicherung für einen Befehl. Nur die Schaltflächen im Bereich Quick Actions tun dies. Vor search-replace, core update, plugin update, theme update, db optimize oder db repair erstellen Sie selbst eine Sicherung auf der Registerkarte Backups der Website. Siehe Taking a Backup.
Arbeiten in der Konsole
Der Bildschirm tut mehr, als einen Befehl nach dem anderen zu akzeptieren.
Voreingestellte Schaltflächen. Gruppierte Verknüpfungen befinden sich über der Eingabeaufforderung: Performance (Cache leeren, Transients löschen, Rewrites leeren, Autoload-Überprüfung), Database (optimieren, überprüfen, reparieren, Größe), Diagnostics (WP-Version, Aktualisierungen überprüfen, Core verifizieren, Cron-Ereignisse), Content (Plugins, Designs, Benutzer auflisten, Cron jetzt ausführen), Security (Admin-Benutzer, Plugin-Checksummen, Salts zurücksetzen, wp-config) und Maintenance (Wartungsmodus ein und aus, Miniaturansichten regenerieren, Status). Ein Klick führt den Befehl aus.
History. Drücken Sie die Pfeile nach oben und unten in der Eingabeaufforderung, um durch Ihre letzten 50 Befehle auf dieser Website zu navigieren.
Snippets. Klicken Sie auf das Lesezeichensymbol neben einem Befehl, um ihn mit einem Namen zu speichern, damit eine lange Eingabe, die Sie jeden Monat verwenden, beim nächsten Mal ein Klick ist.
Umgebungskarte. Über der Eingabeaufforderung zeigt eine Karte die PHP-Version, WordPress-Version, Speicherlimit, derzeit verwendeter Speicher, maximale Upload-Größe und Ausführungszeit-Limit der Website an, mit einer Schaltfläche Copy for support, die alle diese Angaben zusammen mit Ihrer aktiven Plugin-Liste in die Zwischenablage kopiert. Fügen Sie dies in ein Support-Ticket ein und Sie haben sich eine weitere Runde gespart.
Ausgabe kopieren. Jeder Ergebnisblock verfügt über Kopier- und Lösch-Schaltflächen.
Die Ausgabe wird zurückgestreamt, während der Befehl ausgeführt wird, sodass ein langer Vorgang den Fortschritt anzeigt, anstatt stumm zu bleiben.
Befehle, die Sie kennen sollten
Diagnose
core version
core verify-checksums
plugin verify-checksums --all
plugin list --status=active --format=table
db size --tables
option list --autoload=yes
verify-checksums vergleicht Ihre Core- und Plugin-Dateien mit den offiziellen veröffentlichten Kopien und meldet alle Änderungen. Dies ist die schnellste erste Überprüfung auf einer Website, bei der Sie vermuten, dass sie manipuliert wurde.
option list --autoload=yes listet alle Optionen auf, die WordPress bei jeder einzelnen Anforderung lädt. Eine überladene Autoload-Tabelle ist einer der häufigsten Gründe für eine Website, die ohne sichtbaren Grund langsam ist.
Housekeeping
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
Users
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
Alles, was Sie hier eingeben, wird in Ihrem Aktivitätsprotokoll aufgezeichnet, einschließlich Kennwörter. Ändern Sie ein auf diese Weise festgelegtes Kennwort, nachdem Sie sich angemeldet haben. Vollständige Details zur Kontowiederherstellung finden Sie unter Resetting a Lost WordPress Admin Password.
Suchen und Ersetzen
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
Führen Sie immer zuerst einen Test durchlauf durch. Die vollständige Anleitung, einschließlich des Grunds, warum ein Raw-SQL-Austausch eine WordPress-Datenbank beschädigt, finden Sie unter Running a Search and Replace.
Konsole oder Quick Actions?
Beide führen denselben WP-CLI darunter aus. Wählen Sie auf dieser Grundlage:
| Aufgabe | Bessere Route |
|---|---|
| Cache leeren, Plugins aktualisieren, Medien regenerieren | Quick Actions, ein Klick und Sicherung zuerst |
| Suchen und Ersetzen mit Vorschau nach Tabelle | Quick Actions, die Karte "Search & Replace" |
| Alles, was ein bestimmtes Flag benötigt | Konsole |
| Auflisten, Überprüfen, Diagnostizieren | Konsole |
| Ausführung eines überfälligen Cron-Ereignisses | Konsole |
Bearbeitung wp-config.php oder Import einer Datenbank | Beides nicht. Verwenden Sie den Dateimanager oder phpMyAdmin |
Wenn Sie mehr als die Zulassungsliste benötigen
Für unbeschränkte WP-CLI verbinden Sie sich über SSH und führen Sie wp direkt aus dem Verzeichnis Ihrer Website aus. SSH verwendet nur Schlüsselauthentifizierung, daher fügen Sie Ihren öffentlichen Schlüssel zuerst über die Registerkarte Files der Website hinzu, dann SSH Keys. Die Verbindungsdetails, einschließlich des genauen Hosts, Ports und Benutzernamens, werden auf demselben Bildschirm angezeigt. Siehe Adding SSH Keys und Connecting Over SFTP.
Troubleshooting
"'x y' is not in the allowed command list." Der Befehl befindet sich nicht auf der Zulassungsliste. Überprüfen Sie die obige Tabelle auf das nächste zulässige Äquivalent, oder verwenden Sie SSH.
"No results returned. Check that WP-CLI is available." Der Befehl wurde ausgeführt, aber es wurde nichts ausgegeben. Normalerweise korrektes Verhalten für eine Abfrage ohne Ergebnisse.
The command times out. Konsolenbefehle sind auf 60 Sekunden begrenzt. Lange Operationen wie das Regenerieren einer großen Medienbibliothek sollten über Quick Actions ausgeführt werden, das ein längeres Limit verwendet, oder über SSH.
Nothing runs and the buttons are disabled. Ihre Kapsule-Kontirolle ist für diese Website schreibgeschützt. Bitten Sie einen Kontoinhaber, diese zu erhöhen.