WordPress
Utilizzo di WP-CLI sul tuo sito WordPress
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 include una console WP-CLI che esegue comandi sul tuo sito WordPress dal browser, senza client SSH e senza login al server. Questa guida copre dove trovarla, esattamente quali comandi sono consentiti e perché, i tasti di scelta rapida incorporati nella schermata, e cosa fare quando hai bisogno di qualcosa che la console non eseguirà.
Apertura della Console
- Accedi a KPanel e fai clic su Websites nella barra laterale sinistra.
- Fai clic sul tuo sito WordPress.
- Apri la scheda WordPress, quindi la sezione Console.
L'input inizia già con un wp fisso, quindi digiti solo quello che viene dopo. plugin list, non wp plugin list. Premi Invio o fai clic su Run.
Console è una delle sezioni che appaiono sui piani gestiti. Su altri piani la striscia di schede termina invece con un link +8 on Managed. Ogni azione descritta qui che non è un comando grezzo ha un pulsante equivalente altrove in KPanel, quindi nulla è irraggiungibile: la console è un modo più veloce per raggiungere lo stesso motore.
I comandi vengono eseguiti come utente di sistema del tuo sito, all'interno della directory del tuo sito. Non possono vedere o toccare nessun altro sito.
Cosa la Console Eseguirà e Non Eseguirà
La console utilizza un elenco di consentiti. Solo i prefissi di comando sottostanti sono accettati, e tutto il resto viene rifiutato prima di raggiungere il server con un messaggio che nomina il comando rifiutato.
| Area | Consentito |
|---|---|
| Core | core version, core check-update, core update, core is-installed, core verify-checksums |
| Plugin | plugin list, plugin update, plugin install, plugin activate, plugin deactivate, plugin status, plugin get, plugin delete, plugin verify-checksums |
| Temi | theme list, theme update, theme install, theme activate, theme status, theme get, theme delete |
| Utenti | 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 e transitori | cache flush, cache get, cache set, cache add, cache delete, transient get, transient set, transient delete |
| Regole di riscrittura | 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 |
| Modalità manutenzione | maintenance-mode activate, maintenance-mode deactivate, maintenance-mode status |
| Ispezione sola lettura | option get, option list, post list, post get, comment list, comment get |
| Media e lingua | media regenerate, language core install, language core update |
| Ricerca e sostituzione | search-replace |
Le esclusioni deliberate contano più delle inclusioni:
evaleshellsono bloccati. PHP arbitrario e shell arbitraria renderebbero la console equivalente a un prompt root in una scheda del browser.db import,db export,db drop,db queryedb resetsono bloccati. Importazione e ripristino distruggono un database senza passaggio di conferma;db queryè un prompt SQL senza restrizioni. Usa phpMyAdmin invece: Accesso al Database Con phpMyAdmin.config seteconfig deletesono bloccati. Una cattiva scrittura diwp-config.phpmette il sito offline. Leggi i valori qui, cambiali attraverso il file manager.option updateeoption deletesono bloccati. Modificare le opzioni alla cieca è un modo comune per rompere un sito oltre il recupero.
La console non esegue alcun backup per te, su nessun comando. Solo i pulsanti nella sezione Quick Actions lo fanno. Prima di search-replace, core update, plugin update, theme update, db optimize o db repair, esegui tu stesso un backup dalla scheda Backups del sito. Vedi Esecuzione di un Backup.
Lavoro nella Console
La schermata fa più che accettare un comando alla volta.
Pulsanti predefiniti. I tasti di scelta rapida raggruppati si trovano sopra il prompt: Performance (svuota cache, cancella transitori, svuota riscritture, controllo autoload), Database (ottimizza, controlla, ripara, dimensione), Diagnostica (versione WP, controlla aggiornamenti, verifica core, eventi cron), Contenuto (elenca plugin, temi, utenti, esegui cron adesso), Sicurezza (utenti admin, checksum plugin, reimposta salt, wp-config) e Manutenzione (modalità manutenzione attiva e disattiva, rigenerazione miniature, stato). Un clic esegue il comando.
Cronologia. Premi le frecce su e giù nel prompt per scorrere gli ultimi 50 comandi su questo sito.
Snippet. Fai clic sull'icona del segnalibro accanto a un comando per salvarlo con un nome, in modo che una lunga invocazione che usi ogni mese sia un clic la prossima volta.
Scheda ambiente. Sopra il prompt, una scheda mostra la versione PHP del sito, la versione WordPress, il limite di memoria, la memoria attualmente utilizzata, il massimo di caricamento e il limite di tempo di esecuzione, con un pulsante Copy for support che mette tutto ciò più l'elenco dei plugin attivi negli appunti. Incolla quello in un ticket di supporto e hai risparmiato un giro di andata e ritorno.
Copia output. Ogni blocco di risultati ha pulsanti di copia e cancellazione.
L'output scorre indietro mentre il comando viene eseguito, quindi un'operazione lunga mostra l'avanzamento piuttosto che rimanere in silenzio.
Comandi che Vale la Pena Conoscere
Diagnosi
core version
core verify-checksums
plugin verify-checksums --all
plugin list --status=active --format=table
db size --tables
option list --autoload=yes
verify-checksums confronta i tuoi file core e plugin con le copie ufficiali pubblicate e segnala tutto ciò che è stato modificato. È il controllo iniziale più veloce su un sito che sospetti sia stato manomesso.
option list --autoload=yes elenca ogni opzione che WordPress carica su ogni singola richiesta. Una tabella autoload gonfia è una delle cause più comuni di un sito lento senza motivo apparente.
Manutenzione
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
Utenti
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
Qualsiasi cosa digitata qui viene registrata nel log di attività del tuo account, incluse le password. Cambia una password che hai impostato in questo modo una volta che hai effettuato l'accesso. Dettagli completi sul recupero dell'account sono in Ripristino di una Password Admin WordPress Persa.
Ricerca e Sostituzione
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
Esegui sempre un'esecuzione a secco per primo. La procedura dettagliata completa, incluso il motivo per cui una sostituzione SQL grezza corrrompe un database WordPress, è in Esecuzione di una Ricerca e Sostituzione.
Console o Quick Actions?
Entrambi eseguono lo stesso WP-CLI sottostante. Scegli su questa base:
| Attività | Percorso migliore |
|---|---|
| Svuota cache, aggiorna plugin, rigenerazione media | Quick Actions, un clic e esegue un backup prima |
| Ricerca e sostituzione con anteprima per tabella | Quick Actions, la scheda Search & Replace |
| Qualsiasi cosa che necessiti di un flag specifico | Console |
| Elenco, ispezione, diagnosi | Console |
| Esecuzione di un evento cron scaduto | Console |
Modifica di wp-config.php o importazione di un database | Nessuno. Usa il file manager o phpMyAdmin |
Quando Hai Bisogno di Più dell'Elenco di Consentiti
Per WP-CLI senza restrizioni, connettiti tramite SSH e esegui wp direttamente dalla directory del tuo sito. SSH utilizza solo autenticazione a chiave, quindi aggiungi prima la tua chiave pubblica dalla scheda Files, quindi SSH Keys del sito. I dettagli di connessione, inclusi l'host esatto, la porta e il nome utente, sono mostrati nella stessa schermata. Vedi Aggiunta di Chiavi SSH e Connessione tramite SFTP.
Risoluzione dei Problemi
"'x y' is not in the allowed command list." Il comando non è nell'elenco di consentiti. Controlla la tabella sopra per l'equivalente consentito più vicino, o usa SSH.
"No results returned. Check that WP-CLI is available." Il comando è stato eseguito ma non ha stampato nulla. Di solito il comportamento corretto per una query senza corrispondenze.
Il comando scade. I comandi della console sono limitati a 60 secondi. Le operazioni lunghe come la rigenerazione di una grande libreria di media dovrebbero essere eseguite da Quick Actions, che utilizza un limite più lungo, o tramite SSH.
Nulla viene eseguito e i pulsanti sono disabilitati. Il tuo ruolo di account Kapsule è di sola lettura per questo sito. Chiedi a un proprietario dell'account di aumentarlo.