WordPress
WP-CLI gebruiken op uw WordPress Site
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 bevat een WP-CLI console die opdrachten tegen uw WordPress site uitvoert vanuit de browser, zonder SSH-client en zonder serverlogin. Deze gids behandelt waar u deze vindt, exact welke opdrachten zijn toegestaan en waarom, de snelkoppelingen ingebouwd in het scherm, en wat u doet wanneer u iets nodig hebt dat de console niet uitvoert.
Console openen
- Meld u aan bij KPanel en klik op Websites in de linkerzijbalk.
- 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 erachter komt. plugin list, niet wp plugin list. Druk op Enter of klik op Run.
Console is een van de secties die verschijnen op managed plans. Op andere plans eindigt de tabbalk met een +8 on Managed link in plaats daarvan. Elke actie die hier wordt beschreven en geen ruwe opdracht is, heeft een gelijkwaardig knop ergens anders in KPanel, dus niets is onbereikbaar: de console is een snellere manier om dezelfde engine te bereiken.
Opdrachten worden uitgevoerd als de systeemgebruiker van uw site, in de directory van uw site. Ze kunnen geen andere site zien of aanraken.
Wat de Console wel en niet uitvoert
De console gebruikt een allowlist. Alleen de opdrachtprefixen hieronder worden geaccepteerd, en al het andere wordt geweigerd voordat het de server bereikt, met een bericht dat de opdracht noemt die het heeft geweigerd.
| Gebied | Toegestaan |
|---|---|
| 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 |
| 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 |
| Config | 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 opzettelijke uitsluitingen zijn belangrijker dan de insluitingen:
evalenshellzijn geblokkeerd. Willekeurige PHP en willekeurige shell zouden de console gelijk maken aan een root-prompt in een browsertab.db import,db export,db drop,db queryendb resetzijn geblokkeerd. Importeren en herstellen vernietigen een database zonder bevestigingsstap;db queryis een onbeperkte SQL-prompt. Gebruik in plaats daarvan phpMyAdmin: Accessing Your Database With phpMyAdmin.config setenconfig deletezijn geblokkeerd. Een slechtewp-config.phpschrijft de site offline. Lees de waarden hier, wijzig ze via de bestandsbeheerder.option updateenoption deletezijn geblokkeerd. Blinde opties bewerken is een veelvoorkomende manier om een site onherstelbaar te breken.
De console maakt geen backup voor u, op geen enkele opdracht. Alleen de knoppen in de sectie Quick Actions doen dat. Voordat u search-replace, core update, plugin update, theme update, db optimize of db repair uitvoert, maakt u zelf een backup van het tabblad Backups van de site. Zie Taking a Backup.
Werken in de Console
Het scherm doet meer dan alleen één opdracht per keer accepteren.
Vooraf ingestelde knoppen. Gegroepeerde snelkoppelingen bevinden zich boven de prompt: Performance (cache leegmaken, transients wissen, rewrites leegmaken, autoload-controle), Database (optimaliseren, controleren, herstellen, grootte), Diagnostics (WP-versie, updates controleren, core verifiëren, cron-gebeurtenissen), Content (plugins, thema's, gebruikers weergeven, cron nu uitvoeren), Security (admin-gebruikers, plugin-checksums, salts opnieuw instellen, wp-config) en Maintenance (onderhoudsmodus aan en uit, miniaturen regenereren, status). Eén klik voert de opdracht uit.
Geschiedenis. Druk op de pijltjes omhoog en omlaag in de prompt om door uw laatste 50 opdrachten op deze site te navigeren.
Snippets. Klik op het bladwijzerpictogram naast een opdracht om deze met een naam op te slaan, zodat een lange aanroep die u elke maand gebruikt volgende keer slechts één klik is.
Omgevingskaart. Boven de prompt toont een kaart de PHP-versie van de site, WordPress-versie, geheugenlimiet, momenteel gebruikt geheugen, maximale upload en limiet voor uitvoeringstijd, met een knop Copy for support die alles plus uw actieve pluginlijst op het klembord plaatst. Plak dat in een ondersteuningsticket en u hebt een volgend gesprek bespaard.
Uitvoer kopiëren. Elk resultaatblok heeft knoppen voor kopiëren en wissen.
De uitvoer stroomt terug terwijl de opdracht wordt uitgevoerd, dus een lange bewerking toont voortgang in plaats van stil te zitten.
Opdrachten die het waard zijn om te kennen
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 kern- en plugin-bestanden met de officieel gepubliceerde kopieën en rapporteert alles wat is gewijzigd. Het is de snelste eerste controle op een site die u verdacht acht te zijn gemanipuleerd.
option list --autoload=yes somt elke optie op die WordPress bij elk verzoek laadt. Een gezwollen autoload-tabel is een van de meest voorkomende oorzaken van een site die om geen zichtbare reden traag is.
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 is getypt, wordt geregistreerd in het activiteitenlogboek van uw account, inclusief wachtwoorden. Wijzig een wachtwoord dat u op deze manier hebt ingesteld zodra u bent aangemeld. Volledige details over accountherstel vindt u in Resetting a Lost WordPress Admin Password.
Zoeken en vervangen
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
Voer altijd eerst een droge run uit. De volledige walkthrough, inclusief waarom een ruwe SQL-vervanging een WordPress-database beschadigt, vindt u in Running a Search and Replace.
Console of Quick Actions?
Beide voeren dezelfde WP-CLI eronder uit. Kies op basis hiervan:
| Taak | Betere route |
|---|---|
| Cache leegmaken, plugins bijwerken, media regenereren | Quick Actions, één klik en het maakt eerst een backup |
| Zoeken en vervangen met een voorbeeld per tabel | Quick Actions, de Search & Replace-kaart |
| Alles wat een specifieke vlag nodig heeft | Console |
| Weergeven, inspecteren, diagnosticeren | Console |
| Één achterstallige cron-gebeurtenis uitvoeren | Console |
wp-config.php bewerken of een database importeren | Geen van beide. Gebruik de bestandsbeheerder of phpMyAdmin |
Wanneer u meer dan de allowlist nodig hebt
Voor onbeperkte WP-CLI verbindt u via SSH en voert u wp rechtstreeks uit vanuit de directory van uw site. SSH gebruikt alleen sleutelauthenticatie, dus voeg eerst uw openbare sleutel toe vanuit het tabblad Files, dan SSH Keys van de site. De verbindingsgegevens, inclusief de exacte host, poort en gebruikersnaam, worden op datzelfde scherm weergegeven. Zie Adding SSH Keys en Connecting Over SFTP.
Probleemoplossing
"'x y' is not in the allowed command list." De opdracht staat niet op de allowlist. Controleer de tabel hierboven op het dichtstbijzijnde toegestane equivalent, of gebruik SSH.
"No results returned. Check that WP-CLI is available." De opdracht is uitgevoerd maar gaf niets af. Meestal correct gedrag voor een query zonder resultaten.
De opdracht loopt uit. Console-opdrachten zijn beperkt tot 60 seconden. Lange bewerkingen zoals het regenereren van een grote mediabibliotheek moeten vanuit Quick Actions worden uitgevoerd, die een langere limiet gebruikt, of via SSH.
Niets wordt uitgevoerd en de knoppen zijn uitgeschakeld. Uw Kapsule-accountrol is alleen-lezen voor deze site. Vraag een accounteigenaar om deze te verhogen.