WP-CLI: gestire WordPress da console

Se come me anche tu usi WordPress da un po’ di tempo, probabilmente sai quanto può essere comodo lavorare dal pannello di amministrazione. Hai pulsanti, menu, schermate grafiche e tutto sembra a portata di clic. Ma c’è un’alternativa che può sembrare “da smanettoni” e che, una volta provata, rischia di diventare la tua nuova arma segreta: WP-CLI, cioè l’interfaccia a riga di comando per WordPress. Scopriamo di che si tratta… Sei pronto? Partiamo…

WP-CLI per modificare WordPress da console

In questo articolo ti porto a scoprire cos’è WP-CLI, come si installa e come lo puoi usare per semplificarti la vita da admin di WordPress. Ti guiderò in procedure passo passo, esempi concreti e anche qualche consiglio di sicurezza che di solito viene sottovalutato.

Perché dovresti usare WP-CLI

Immagina questa scena: devi aggiornare dieci plugin su un sito. Normalmente entri in WordPress, vai nella sezione Plugin, selezioni, aggiorni… e aspetti. Con WP-CLI puoi fare la stessa cosa con un comando:

wp plugin update --all

In due secondi hai risolto. Oppure pensa a quando devi cambiare l’URL del sito dopo una migrazione: niente più ricerca manuale nel database, basta un comando search-replace e via.

I vantaggi non si fermano qui:

• Risparmi tempo, perché i comandi sono più rapidi dei clic.
• Puoi automatizzare operazioni ripetitive con script.
• Riduci il rischio di dimenticare un passaggio.
• Puoi gestire siti anche quando l’interfaccia web non è accessibile.

Requisiti per iniziare

Prima di fiondarti nel terminale, fermati un attimo: WP-CLI non funziona su qualunque ambiente, quindi ci sono alcuni requisiti minimi.

• Accesso SSH al server: ti serve poter entrare nel server via terminale. Molti hosting moderni lo offrono già, ma controlla.
• PHP aggiornato: WP-CLI richiede almeno PHP 5.6, ma oggi è meglio se usi versioni molto più recenti (7.4 o 8.x).
• WordPress installato: WP-CLI funziona dalla cartella in cui si trova il tuo wp-config.php.

Se sei su Windows, puoi usare il terminale integrato con PowerShell e OpenSSH, oppure il client SSH Putty, oppure ancora meglio WSL (Windows Subsystem for Linux). Se sei su macOS o Linux, hai già tutto a portata di mano.

Installazione passo passo di WP-CLI

Vediamo la procedura più comune per installare WP-CLI sul tuo server o sul tuo computer.

1. Scarica il file Phar (un archivio PHP eseguibile):

   curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
   

2. Verifica che funzioni:

   php wp-cli.phar --info
   

   Se vedi un output con la versione di WP-CLI e informazioni su PHP, sei a buon punto.

3. Rendi il file eseguibile:

   chmod +x wp-cli.phar
   

4. Spostalo in una cartella del sistema (così puoi chiamarlo con wp da qualsiasi directory):

   sudo mv wp-cli.phar /usr/local/bin/wp
   

5. Test finale:

   wp --info
   

   Se ottieni di nuovo le informazioni, significa che sei pronto a lavorare.

Questa è la via più rapida. Se preferisci, puoi installare WP-CLI anche via Composer o tramite i pacchetti del tuo sistema operativo, ma la versione Phar rimane quella più universale.

Prime mosse con WP-CLI

Ora che hai WP-CLI installato, cominciamo a sporcarci le mani. Posizionati nella cartella root del tuo sito WordPress (dove sta wp-config.php) e prova qualche comando base.

• Controllare la versione di WordPress:

  wp core version
  

• Verificare i plugin installati:

  wp plugin list
  

• Aggiornare tutti i plugin:

  wp plugin update --all
  

• Aggiornare WordPress core:

  wp core update
  

Sono comandi semplici, ma già ti fanno capire la potenza dello strumento.

Gestire database e backup

Una delle cose più comode di WP-CLI è poter lavorare con il database senza aprire phpMyAdmin.

• Esportare il database in un file SQL:

  wp db export backup.sql
  

• Importare un database:

  wp db import backup.sql
  

• Ottimizzare il database:

  wp db optimize
  

Piccolo consiglio da non dimenticare: prima di ogni operazione delicata fai un export. Non ti costa nulla e ti salva la vita se qualcosa va storto.

La magia del search-replace

Uno degli usi più gettonati di WP-CLI è quando devi cambiare gli URL dopo una migrazione (ad esempio da staging.tuosito.it a www.tuosito.it).

Con WP-CLI puoi fare:

wp search-replace 'https://staging.tuosito.it' 'https://www.tuosito.it' --all-tables

C’è un dettaglio importante: WP-CLI gestisce correttamente i dati serializzati del database. Significa che non rompe i widget o le opzioni che contengono array salvati.

Trucchetto extra: prova sempre con l’opzione --dry-run prima di lanciare il comando “vero”:

wp search-replace 'staging.tuosito.it' 'www.tuosito.it' --all-tables --dry-run

Così WP-CLI ti mostra cosa cambierebbe, senza toccare nulla.

Gestire utenti, post e media

WP-CLI non si limita a plugin e core: puoi anche gestire contenuti e utenti.

• Creare un nuovo utente:

  wp user create mario mario@example.com --role=author --user_pass=PasswordSicura123
  

• Cambiare la password di un utente:

  wp user update mario --user_pass=NuovaPassword!
  

• Pubblicare un nuovo post:

  wp post create --post_title="Nuovo Articolo" --post_content="Contenuto qui..." --post_status=publish
  

• Rigenerare le miniature (utile dopo aver cambiato tema):

  wp media regenerate
  

Questi comandi sono perfetti se devi fare modifiche rapide senza aprire l’editor.

Sicurezza e buone pratiche

Qui voglio insistere: WP-CLI è potente, ma va usato con attenzione.

• Non eseguire WP-CLI come root. Se lanci comandi con privilegi di root, qualsiasi codice PHP del tuo sito potrebbe eseguire azioni pericolose sul sistema. Usa l’utente web del server (ad esempio www-data su Linux) o un utente con permessi limitati.
• Fai sempre un backup prima di operazioni grosse. Che sia un export del database o una copia dei file, non fidarti del “tanto andrà tutto bene”.
• Prova i comandi con --dry-run quando disponibile. Ti evita sorprese.
• Tieni aggiornato WP-CLI stesso con:

  wp cli update
  

Funzioni avanzate che ti semplificano la vita

Oltre alle basi, WP-CLI offre chicche che magari non tutti conoscono:

• Alias e configurazione: puoi creare un file wp-cli.yml o config.yml nella tua home per definire alias, percorsi o URL di default. Così non devi riscrivere parametri ogni volta.
• Comandi combinati in script: immagina di avere dieci siti su cui aggiornare WordPress e plugin. Puoi scrivere uno script bash che entri in ogni cartella ed esegua i comandi in automatico.
• Pacchetti WP-CLI: ci sono estensioni che aggiungono comandi extra. Ad esempio puoi installare pacchetti per gestire WooCommerce, fare deploy o creare scaffolding per plugin e temi.

Queste funzioni sono oro puro se gestisci più siti o lavori come sviluppatore.

Cosa fare se qualcosa va storto

Nonostante tutte le precauzioni, può capitare di incappare in errori. Alcuni suggerimenti pratici:

• Se un comando non funziona, prova ad aggiungere --debug alla fine per avere più informazioni.
• Se vedi errori di permessi, assicurati di essere nella cartella giusta e di usare l’utente corretto.
• Se WP-CLI non riconosce WordPress, controlla che ci sia wp-config.php nella directory.
• In caso di guai grossi, ricordati del backup che hai fatto prima (vero che l’hai fatto?).

Conclusioni

Arrivati fin qui, credo che tu abbia capito quanto WP-CLI possa rivoluzionare il tuo modo di gestire WordPress. All’inizio può sembrare un salto indietro nel tempo – niente bottoni, solo testo bianco su sfondo nero – ma in realtà è l’opposto: è un salto avanti in termini di velocità, controllo e professionalità.

Ti permette di fare aggiornamenti in massa con un comando, di migrare un sito senza patemi, di rigenerare le miniature o creare utenti in pochi secondi. E soprattutto, ti dà quella sensazione di avere il pieno controllo del tuo sito, senza dipendere troppo da interfacce grafiche che a volte rallentano.

Il mio consiglio è: inizia dalle basi, gioca con i comandi più semplici e prendi confidenza. Poi, man mano, esplora quelli più avanzati, costruisci i tuoi script e rendi WP-CLI parte del tuo flusso di lavoro quotidiano. Ti accorgerai che gestire WordPress non è mai stato così rapido e, perché no, anche divertente.