KPanel bevat een WP-CLI console waarmee u opdrachten tegen uw WordPress-site uitvoert vanuit de browser, zonder SSH-client en zonder serverlogin. Deze handleiding behandelt waar u de console vindt, welke opdrachten precies zijn toegestaan en waarom, de snelkoppelingen die in het scherm zijn ingebouwd, en wat u moet doen wanneer u iets nodig heeft dat de console niet uitvoert.
De console openen
- Meld u aan bij KPanel en klik op Websites in de linker zijbalk.
- Klik op uw WordPress-site.
- Open het tabblad WordPress en vervolgens de sectie Console.
De invoer begint al met een vaste wp, dus u typt alleen wat daarna komt. plugin list, niet wp plugin list. Druk op Enter of klik op Uitvoeren.
Console is een van de secties die bij beheerde abonnementen verschijnen. Bij andere abonnementen eindigt de tabbladenrij in plaats daarvan met een link +8 bij Managed. Elke hier beschreven actie die geen ruwe opdracht is, heeft elders in KPanel een gelijkwaardige knop, dus niets is onbereikbaar: de console is simpelweg een snellere manier om dezelfde engine te bereiken.
Opdrachten worden uitgevoerd als de eigen systeemgebruiker van uw site, binnen de map van uw site. Ze kunnen geen andere site zien of aanraken.
Wat de console wel en niet uitvoert
De console gebruikt een toelatingslijst. Alleen de onderstaande opdrachtprefixen worden geaccepteerd, en al het andere wordt al geweigerd voordat het de server bereikt, met een melding die de geweigerde opdracht noemt.
| Gebied | Toegestaan |
|---|---|
| Kern | 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 |
| Thema's | theme list, theme update, theme install, theme activate, theme status, theme get, theme delete |
| Gebruikers | 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 en transients | cache flush, cache get, cache set, cache add, cache delete, transient get, transient set, transient delete |
| Rewrite-regels | rewrite flush, rewrite list, rewrite structure |
| Cron | cron event list, cron event run, cron schedule list |
| Configuratie | config get, config list, config has, config shuffle-salts |
| Onderhoudsmodus | maintenance-mode activate, maintenance-mode deactivate, maintenance-mode status |
| Alleen-lezen inspectie | option get, option list, post list, post get, comment list, comment get |
| Media en taal | media regenerate, language core install, language core update |
| Zoeken en vervangen | search-replace |
De bewuste uitsluitingen zijn belangrijker dan de inclusies:
evalenshellzijn geblokkeerd. Willekeurige PHP en willekeurige shell zouden de console gelijkwaardig maken aan een rootprompt in een browsertabblad.db import,db export,db drop,db queryendb resetzijn geblokkeerd. Importeren en resetten vernietigen een database zonder bevestigingsstap;db queryis een onbeperkte SQL-prompt. Gebruik in plaats daarvan phpMyAdmin: Uw database benaderen met phpMyAdmin.config setenconfig deletezijn geblokkeerd. Een foutewp-config.php-schrijfactie haalt de site offline. Lees de waarden hier, wijzig ze via de bestandsbeheerder.option updateenoption deletezijn geblokkeerd. Blind opties bewerken is een veelvoorkomende manier om een site onherstelbaar te breken.
De console maakt voor geen enkele opdracht zelf een back-up. Alleen de knoppen in de sectie Snelle acties doen dat. Maak voordat u search-replace, core update, plugin update, theme update, db optimize of db repair uitvoert, zelf een back-up vanuit de pagina Back-ups van de site. Zie Een back-up maken.
Werken in de console
Het scherm doet meer dan slechts één opdracht tegelijk accepteren.
Preset-knoppen. Boven de prompt staan gegroepeerde snelkoppelingen: Performance (cache leegmaken, transients wissen, rewrites doorvoeren, autoload-controle), Database (optimaliseren, controleren, repareren, grootte), Diagnostiek (WP-versie, updates controleren, core verifiëren, cron-events), Content (plugins, thema's en gebruikers weergeven, cron nu uitvoeren), Beveiliging (beheerdersgebruikers, plugin-checksums, salts resetten, wp-config) en Onderhoud (onderhoudsmodus aan en uit, thumbnails opnieuw genereren, status). Eén klik voert de opdracht uit.
Geschiedenis. Druk op de pijltjestoetsen omhoog en omlaag in de prompt om door uw laatste 50 opdrachten op deze site te bladeren.
Snippets. Klik op het bladwijzericoon naast een opdracht om deze met een naam op te slaan, zodat een lange opdracht die u elke maand gebruikt de volgende keer één klik is.
Omgevingskaart. Boven de prompt toont een kaart de PHP-versie van de site, WordPress-versie, geheugenlimiet, momenteel gebruikt geheugen, uploadmaximum en uitvoeringstijdlimiet, met een knop Kopiëren voor ondersteuning die dit alles plus uw actieve pluginlijst op het klembord zet. Plak dit in een support ticket en u heeft een heen-en-weer bespaard.
Uitvoer kopiëren. Elk resultaatblok heeft kopieer- en wisknoppen.
De uitvoer stroomt terug terwijl de opdracht wordt uitgevoerd, zodat een lange bewerking voortgang toont in plaats van stil te blijven.
Opdrachten die het kennen waard zijn
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 vergelijkt uw core- en pluginbestanden met de officieel gepubliceerde versies en meldt alles wat is gewijzigd. Het is de snelste eerste controle op een site waarvan u vermoedt dat ermee is geknoeid.
option list --autoload=yes toont elke optie die WordPress bij elk afzonderlijk verzoek laadt. Een opgeblazen autoload-tabel is een van de meest voorkomende oorzaken van een site die traag is zonder zichtbare reden.
Onderhoud
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
Gebruikers
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
Alles wat hier wordt getypt, wordt vastgelegd in het activiteitenlogboek van uw account, inclusief wachtwoorden. Wijzig een wachtwoord dat u op deze manier instelt zodra u bent ingelogd. Volledige details over accountherstel vindt u in Een verloren WordPress-beheerderswachtwoord resetten.
Zoeken en vervangen
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
Voer altijd eerst een dry run uit. De volledige uitleg, inclusief waarom een ruwe SQL-vervanging een WordPress-database corrumpeert, vindt u in Een zoek-en-vervang-actie uitvoeren.
Console of Snelle acties?
Beide draaien onderliggend dezelfde WP-CLI. Kies op deze basis:
| Taak | Betere route |
|---|---|
| Cache legen, plugins updaten, media opnieuw genereren | Snelle acties, één klik en het maakt eerst een back-up |
| Zoeken en vervangen met een voorbeeldweergave per tabel | Snelle acties, de kaart Zoeken & vervangen |
| Alles waarvoor een specifieke vlag nodig is | Console |
| Weergeven, inspecteren, diagnosticeren | Console |
| Eén achterstallige cron-event uitvoeren | Console |
wp-config.php bewerken of een database importeren | Geen van beide. Gebruik de bestandsbeheerder of phpMyAdmin |
Wanneer u meer nodig heeft dan de toelatingslijst
Voor onbeperkte WP-CLI maakt u verbinding via SSH en voert u wp rechtstreeks uit vanuit de map van uw site. SSH gebruikt uitsluitend sleutelauthenticatie, dus voeg eerst uw publieke sleutel toe vanuit Instellingen van de site, vervolgens het tabblad SSH-sleutels. De verbindingsgegevens, inclusief de exacte host, poort en gebruikersnaam, worden op datzelfde scherm getoond. Zie SSH-sleutels toevoegen en Verbinden via SFTP.
Probleemoplossing
"'x y' staat niet op de lijst met toegestane opdrachten." De opdracht staat niet op de toelatingslijst. Controleer de bovenstaande tabel voor het dichtstbijzijnde toegestane equivalent, of gebruik SSH.
"Geen resultaten geretourneerd. Controleer of WP-CLI beschikbaar is." De opdracht is uitgevoerd maar heeft niets afgedrukt. Meestal correct gedrag bij een query zonder overeenkomsten.
De opdracht loopt vast op een time-out. Consoleopdrachten zijn beperkt tot 60 seconden. Lange bewerkingen zoals het opnieuw genereren van een grote mediabibliotheek kunt u beter uitvoeren vanuit Snelle acties, dat een langere limiet gebruikt, of via SSH.
Er gebeurt niets en de knoppen zijn uitgeschakeld. Uw KapsuleHost-accountrol is voor deze site alleen-lezen. Vraag een accounteigenaar om deze te verhogen.