WP-CLI

WP-CLI (WordPress Command Line Interface) è un potente strumento per gestire un’installazione di WordPress direttamente dalla riga di comando o dal terminale. Invece di utilizzare la dashboard standard di WordPress, è possibile eseguire comandi per svolgere attività come l’aggiornamento dei plugin, la gestione dei temi e la configurazione delle impostazioni, tutto dal proprio terminale.

L’uso di WP-CLI offre numerosi vantaggi, tra cui:

• Velocità: l’esecuzione di attività tramite la riga di comando è spesso più veloce rispetto alla navigazione nell’interfaccia di amministrazione di WordPress, soprattutto per le attività ripetitive.
• Automazione: WP-CLI può essere integrato negli script per automatizzare i flussi di lavoro.
• Gestione remota: WP-CLI permette di gestire i siti WordPress da remoto.
• Flessibilità: la possibilità di eseguire comandi e script offre un livello di controllo e personalizzazione.

Accesso a WP-CLI su Kinsta

WP-CLI v2 è installato di default su tutti i nostri server. Per accedere a WP-CLI, dovete connettervi al server con SSH e navigare nella root dei documenti del sito. Kinsta fornisce l’accesso SSH con tutti i piani di hosting WordPress gestiti.

1. Connettersi al server con SSH

Il metodo più semplice per connettersi tramite SSH è quello di utilizzare un nome utente e una password. I passaggi per connettersi variano a seconda del sistema operativo in uso.

Windows

Gli utenti di Windows hanno bisogno di un client di terminale per connettersi a SSH. Noi consigliamo di scaricare il client gratuito PuTTY utilizzando il programma di installazione .msi.

1. Avviate PuTTY e inserite l’indirizzo IP del vostro host e il numero di porta univoco (entrambi si trovano in MyKinsta > Siti > nome del sito > Info > SFTP/SSH). Poi cliccate su Apri.
2. Se è la prima volta che vi connettete, molto probabilmente vedrete una richiesta di chiave rsa2. Cliccate su Sì per fidarvi dell’host in futuro.
3. Nella schermata del terminale, inserite il nome utente di Kinsta (che si trova in MyKinsta > Siti > nome del sito > Info > SFTP/SSH) e premete Invio.
4. Inserite la password Kinsta (che si trova in MyKinsta > Siti > nome del sito > Info > SFTP/SSH) e premete nuovamente Invio.

Ora siete connessi via SSH al vostro sito WordPress.

Mac/Linux

1. Aprite un nuovo terminale da Applicazioni > Utilità > Terminale.
2. In MyKinsta, navigate in Siti > nome del sito > Info > SFTP/SSH e sul comando del terminale SSH cliccate su Copia negli appunti .
3. Incollate il comando del terminale SSH nel terminale e premete Invio.
4. Inserite la password di Kinsta (che si trova in MyKinsta > Siti > nome del sito > Info > SFTP/SSH) e premete nuovamente Invio.

Ora siete connessi via SSH al vostro sito WordPress.

2. Navigare nella document root del sito

Per eseguire i comandi WP-CLI, dovete prima navigare nella document root del sito; è qui che si trovano i file di WordPress (come wp-config.php, wp-content, wp-admin e wp-includes). Per navigare nella document root del sito su Kinsta, inserite il seguente comando:

cd public

Ora potete utilizzare i comandi WP-CLI sulla vostra installazione di WordPress ospitata su Kinsta. Per un elenco completo dei comandi WP-CLI disponibili, consultate la documentazione per sviluppatori di WordPress.

Comandi WP-CLI utili

Di seguito trovate un elenco di comandi WP-CLI che potrebbero esservi utili. Per un elenco completo dei comandi WP-CLI disponibili, compresi i parametri e le opzioni globali, consultate la documentazione per gli sviluppatori di WordPress.

Opzioni utili

Di seguito trovate un elenco di opzioni utili che potete aggiungere alla fine dei vostri comandi:

• --skip-themes: impedisce il caricamento dei temi di WordPress quando eseguite un comando WP-CLI. Questo è utile se c’è un problema in uno dei temi che causa conflitti con i comandi WP-CLI.
• --skip-plugins: impedisce il caricamento dei plugin di WordPress quando eseguite un comando WP-CLI. È utile se un problema in uno dei plugin causa conflitti con i comandi WP-CLI.
• --all: applica un comando a tutti gli elementi rilevanti. Ad esempio, se volete aggiornare tutti i plugin o gli utenti.
• --dry-run: può essere utilizzato per simulare l’esecuzione di un comando senza apportare modifiche effettive. Mostra cosa accadrebbe se il comando fosse eseguito, ma non esegue alcuna azione. Ad esempio, se eseguite una ricerca e una sostituzione, aggiornate tutti i plugin o cancellate in blocco i post.
• --format=<format>: specifica il formato di uscita per l’esportazione dei dati. Ad esempio, quando eseguite wp plugin list o wp user list potreste volere il formato table, json o csv.

Plugin

Visualizzare l’elenco dei plugin

wp plugin list

Attivare un plugin

Per attivare un plugin, usate il seguente comando, sostituendo $plugin con il nome del plugin dal sito wp plugin list.

wp plugin activate $plugin

Disattivare un plugin

Per disattivare un plugin, usate il seguente comando, sostituendo $plugin con il nome del plugin da wp plugin list.

wp plugin deactivate $plugin

Aggiornare un plugin specifico

Per aggiornare un plugin, usate il seguente comando, sostituendo $plugin con il nome del plugin da wp plugin list.

wp plugin update $plugin

Aggiornare tutti i plugin

wp plugin update --all

Ripristinare un plugin

Se aggiornate un plugin che poi rompe qualcosa nel sito, potete ripristinarlo installando una versione specifica con il seguente comando, sostituendo $plugin con il nome del plugin da wp plugin list e $versioncon il numero di versione richiesto.

wp plugin update $plugin --version=$version

URL

Impostare l’URL della home

Per impostare l’URL della vostra pagina iniziale, usate il seguente comando, sostituendo $URL con l’URL richiesto.

wp option update home '$URL'

Impostare l’URL del sito

Per impostare l’URL del sito, usate il seguente comando, sostituendo $URL con l’URL richiesto.

wp option update siteurl '$URL'

Utenti

Elencare tutti gli utenti di WordPress

wp user list

Creare un nuovo utente

Per creare un nuovo utente, usate il seguente comando, sostituendo $username e $emailaddress con le credenziali dell’utente e $role con il ruolo che volete assegnare al nuovo utente, ad esempio amministratore.

wp user create $username $emailaddress -–role=$role

Reimpostare la password di un utente

Per creare un nuovo utente, usate il seguente comando, sostituendo $usernamecon il nome utente richiesto da wp user list.

wp user reset-password $username

Aggiornare i dati di un utente

Per aggiornare un utente, usate il seguente comando, sostituendo $user con il nome utente richiesto da wp user list, $field con il campo che volete aggiornare e $value con i nuovi dati che volete inserire.

wp user update $user -—$field=$value

Cache

Per utilizzare i comandi di cancellazione della cache elencati di seguito, il plugin Kinsta Must Use (MU) deve essere installato sul sito.

Svuotare tutta la cache

Per svuotare tutta la cache, compresa la cache del sito, la cache edge, la cache del CDN e la cache di Redis, usate il seguente comando:

wp kinsta cache purge --all

Svuotare la cache a pagina intera e la cache edge

Per svuotare la cache a pagina intera e la cache edge, usate il seguente comando:

wp kinsta cache purge

Svuotare la cache del sito senza svuotare la cache edge

Per svuotare solo la cache del sito, usate il seguente comando:

wp kinsta cache purge --site

Svuotare la cache CDN

Per svuotare solo la cache CDN, usate il seguente comando:

wp kinsta cache purge --cdn

Svuotare la cache di Redis

Per svuotare solo la cache di Redis, usate il seguente comando:

wp kinsta cache purge --object

Svuotare la cache degli oggetti

Svuotate la cache degli oggetti del vostro sito con il seguente comando:

wp cache flush

Questo potrebbe comportare un leggero aumento dei tempi di caricamento temporaneo a causa della ricostruzione della cache.

Ricerca e sostituzione

Quando eseguite una ricerca e sostituzione sul vostro sito WordPress, vi consigliamo di eseguire un backup e di utilizzare l’opzione --dry-run per vedere cosa verrà sostituito prima di eseguire il comando.

Sostituire il vecchio dominio con il nuovo

Per sostituire un vecchio URL con un nuovo URL, usate il seguente comando, sostituendo $old-domain con l’URL che volete sostituire e $new-domain con l’URL con cui volete sostituirlo:

wp search-replace '$old-domain' '$new-domain' --skip-columns=guid

--skip-columns=guid è consigliato per evitare di alterare accidentalmente gli URL memorizzati come identificatori univoci nella colonna guid del database, il che potrebbe interrompere gli URL dei post. Questo comando può essere utilizzato anche per sostituire i domini degli indirizzi e-mail.

Sostituire HTTP con HTTPS

Per aggiornare gli URL da HTTP a HTTPS, usate il seguente comando:

wp search-replace 'http://' 'https://' --skip-columns=guid

--skip-columns=guid è consigliato per evitare di alterare accidentalmente gli URL memorizzati come identificatori unici nella colonna guid del database, il che potrebbe causare problemi con gli allegati multimediali.

Risoluzione dei problemi

Se avete problemi nell’eseguire i comandi in WP-CLI, questo potrebbe essere dovuto a un errore fatale di un tema o di un plugin. Potete aggiungere quanto segue al vostro comando WP-CLI per saltare il caricamento di temi e plugin:

--skip-themes --skip-plugins

Ad esempio, per ottenere un elenco di utenti e saltare il caricamento di temi e plugin, potete eseguire il comando:

wp user list --skip-themes --skip-plugins

Se volete saltare dei plugin specifici, potete utilizzare la seguente procedura, sostituendo $plugin con il nome del plugin e utilizzando una virgola per separare ogni plugin:

--skip-plugins=$plugin,$plugin

Ad esempio:

wp user list --skip-plugins=wordpress-seo,wordfence