WP-CLI è un’interfaccia a riga di comando per WordPress. Ti permette di installare Plugin, gestire utenti, eseguire operazioni sul database e altro ancora, tutto da un terminale, senza toccare l’interfaccia di amministrazione di WordPress. Questa guida copre l’installazione su Linux, macOS e Windows, oltre ai passaggi di verifica e risoluzione dei problemi più comuni.
In breve: su Linux o macOS (metodo phar), scarica il file Phar, rendilo eseguibile e spostalo nel tuo PATH. Su macOS la via più rapida è
brew install wp-cli. Su Windows installa Cygwin o usa WSL2, poi segui i passaggi per Linux. Eseguiwp --versionper confermare che l’installazione ha funzionato.
Riferimento rapido per piattaforma e metodo
| Piattaforma | Metodo consigliato | Alternativa |
|---|---|---|
| Linux | curl (phar) | Composer |
| macOS | Homebrew (brew install wp-cli) |
curl (phar) |
| Windows (Cygwin) | curl (phar) nel terminale Cygwin | — |
| Windows (WSL2) | Segui i passaggi per Linux dentro WSL2 | — |
WP-CLI può essere installato anche come pacchetto Composer; consulta la documentazione ufficiale di WP-CLI per le istruzioni su require wp-cli/wp-cli.
Prerequisiti
- PHP 5.4 o successivo
- WordPress 3.7 o successivo
- Accesso SSH al tuo server per le installazioni su Linux
- Privilegi di amministratore per le installazioni su Windows
Installazione su Linux
- Scarica WP-CLI:
Apri una finestra di terminale e scarica il file Phar di WP-CLI usando curl:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.pharNei nostri test su Ubuntu 22.04 LTS, il metodo curl si completa in meno di un minuto su una connessione server standard.
- Rendi WP-CLI eseguibile:
Rendi eseguibile il file Phar scaricato:
chmod +x wp-cli.phar- Sposta WP-CLI nella directory bin:
Sposta l’eseguibile in una directory del tuo PATH. La directory /usr/local/bin è la posizione standard:
sudo mv wp-cli.phar /usr/local/bin/wp- Verifica l’installazione di WP-CLI:
Controlla che WP-CLI sia installato correttamente visualizzando le informazioni di sistema:
wp --infoInstallazione su macOS
macOS è l’ambiente di sviluppo principale per molti sviluppatori WordPress. Il metodo Homebrew è il più semplice e mantiene WP-CLI aggiornato automaticamente.
Installazione tramite Homebrew (consigliato)
Se hai installato Homebrew, esegui:
brew install wp-cliDopo l’installazione, conferma che funzioni:
wp --versionInstallazione tramite Phar (senza Homebrew)
Se preferisci il metodo manuale, i passaggi Phar di Linux funzionano su macOS senza modifiche:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
wp --versionInstallazione su Windows
- Scarica WP-CLI:
Visita la pagina GitHub di WP-CLI e scarica l’ultimo file Phar da:
https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar- Scarica e installa Cygwin:
WP-CLI richiede un terminale simile a Unix. Scarica e installa Cygwin dal sito ufficiale:
https://www.cygwin.com/Durante l’installazione, assicurati di installare i pacchetti curl, php, php-curl, php-mbstring, openssl e openssh.
- Sposta WP-CLI nella directory Cygwin:
Sposta il file wp-cli.phar nella tua home directory di Cygwin, di solito C:cygwin64homeYour_User.
- Rendi WP-CLI eseguibile:
Apri il terminale Cygwin e spostati nella tua home directory usando cd ~. Poi rendi eseguibile il file Phar:
chmod +x wp-cli.phar- Sposta WP-CLI nella directory bin:
Sposta l’eseguibile nel tuo PATH. La directory /usr/bin dentro Cygwin è la posizione standard:
mv wp-cli.phar /usr/bin/wp- Verifica l’installazione di WP-CLI:
Controlla che WP-CLI sia installato correttamente visualizzando le informazioni di sistema:
wp --infoVerifica l’installazione
Dopo aver installato WP-CLI con uno qualsiasi dei metodi, conferma che funzioni con due comandi.
Controlla la versione:
wp --versionIl comando restituisce una stringa di versione tipo WP-CLI x.y.z. Consulta la pagina delle release di WP-CLI per confermare di avere l’ultima versione.
Esegui un controllo di salute di base:
wp doctor checkQuesto verifica problemi di configurazione comuni. Eseguilo da una directory WordPress per ottenere risultati specifici del sito. Il comando doctor fa parte del pacchetto wp-cli/doctor-command, che richiede un’installazione separata: vedi il README di wp-cli/doctor-command per le istruzioni di configurazione.
Risoluzione dei problemi
Dai ticket di supporto di WP STAGING, la causa più comune dei fallimenti di installazione di WP-CLI è una configurazione errata del PATH. Qui sotto trovi i principali errori e le relative soluzioni.
wp: command not found dopo l’installazione (Linux/macOS)
Il file Phar di WP-CLI non è stato posizionato in una directory del tuo $PATH. Conferma dove è stato spostato wp:
which wpSe il comando non restituisce nulla, il binario non è nel tuo PATH. Aggiungi /usr/local/bin al tuo PATH modificando ~/.bashrc o ~/.zshrc:
export PATH="$PATH:/usr/local/bin"
source ~/.bashrcPoi riprova wp --version.
PHP non trovato nel PATH (Windows / Cygwin)
WP-CLI richiede che PHP sia accessibile dal terminale. In Cygwin, verifica che PHP sia installato eseguendo php --version. Se restituisce un errore, riesegui l’installer di Cygwin e aggiungi il pacchetto php.
Permesso negato sul file Phar (Linux/macOS)
Se vedi un errore "Permission denied" quando sposti il file in /usr/local/bin, anteponi al comando sudo:
sudo mv wp-cli.phar /usr/local/bin/wpSe sudo non è disponibile (ad esempio sull’Hosting condiviso), sposta il file in una directory scrivibile dall’utente (ad esempio ~/bin/) e aggiungi quella directory al tuo PATH.
Mismatch di versione PHP
WP-CLI richiede PHP 5.4 o successivo. Esegui php --version per controllare la versione a cui si riferisce il tuo terminale. Se hai più versioni di PHP installate, la versione che WP-CLI prende è determinata dall’ordine del PATH. Nella maggior parte dei casi vediamo questo problema su server che eseguono una versione di PHP inferiore al minimo 5.4: aggiornare PHP per soddisfare il requisito risolve il problema. Consulta php.net/manual/en/install.php per le indicazioni di installazione di PHP.
Conclusione
Ora che WP-CLI è installato, puoi iniziare a usarlo per gestire il tuo sito WordPress dalla riga di comando. La documentazione ufficiale di WP-CLI copre il riferimento completo dei comandi e il manuale.
