WP-CLI: guida pratica alla gestione di WordPress da riga di comando

WP-CLI è l’interfaccia ufficiale a riga di comando per gestire WordPress. Consente molte attività senza wp-admin ed è utile per manutenzione, migrazioni, automazione e troubleshooting.

WP-CLI non è disponibile presso ogni provider. Servono accesso SSH, WP-CLI installato e permessi sulla directory WordPress.

Cos’è WP-CLI e quando usarlo

Puoi verificare core, plugin, temi e utenti, esportare il database, svuotare l’object cache e sostituire URL in modo controllato. Non sostituisce backup, staging o test di compatibilità.

Prima di iniziare

• Verifica che il piano includa SSH e WP-CLI.
• Crea un backup completo prima di aggiornamenti o modifiche.
• Usa staging per cambiamenti rischiosi.
• Accedi con un account limitato, non root.
• Conferma il document root.

1. Collegamento SSH e verifica

cd /path/to/wordpress
wp --info
wp core version

Se wp non viene trovato, chiedi al provider. Per “This does not seem to be a WordPress installation”, verifica la cartella o usa --path=/percorso/corretto.

2. Core WordPress

wp core version
wp core check-update
wp core verify-checksums

I checksum individuano file core modificati, ma non controllano plugin, temi o uploads. Prima di wp core update, esegui backup e test in staging.

3. Plugin e temi

wp plugin list
wp plugin list --update=available
wp plugin status plugin-slug
wp plugin activate plugin-slug
wp plugin deactivate plugin-slug

wp theme list
wp theme status theme-slug

Non disattivare in massa i plugin di un e-commerce live senza manutenzione pianificata. Testa in staging e aggiorna singolarmente.

wp plugin update plugin-slug
wp theme update theme-slug

4. Utenti

wp user list --fields=ID,user_login,user_email,roles
wp user get 1

Controlla amministratori sconosciuti, ma non eliminare utenti prima di verificarne identità e contenuti. Non inserire password nella cronologia shell.

5. Database

Avviso: i comandi database possono coinvolgere l’intero sito. Crea un backup prima di scritture o ottimizzazioni.

wp db check
wp db export wordpress-before-change.sql

Verifica che l’export esista, abbia dimensioni plausibili e sia fuori dalla directory web pubblica. Database grandi possono richiedere altra procedura.

6. Cache

wp cache flush

Il comando svuota l’object cache WordPress, non necessariamente page cache, CDN o cache server.

7. Aggiornamenti

wp core check-update
wp plugin list --update=available
wp theme list --update=available

Questi sono controlli. Prima degli update prepara backup, staging e rollback.

8. Search-replace con anteprima

WP-CLI gestisce dati serializzati, ma una sostituzione errata può modificare molti record. Esegui prima:

wp search-replace 'https://old.example' 'https://new.example' --all-tables-with-prefix --dry-run

Controlla tabelle e sostituzioni. Ripeti senza --dry-run solo dopo verifica e backup. Multisite e tabelle personalizzate richiedono controlli extra.

Problemi comuni

• Command not found: WP-CLI non è disponibile o non è nel PATH.
• Percorso errato: verifica document root o --path.
• Errore database: controlla wp-config.php e servizio database.
• Permission denied: verifica proprietario e permessi; non usare sudo senza motivo.
• Errore fatale: consulta i log e annulla l’ultima modifica.
• Timeout/memoria: dividi l’attività o contatta il provider.

Pratiche di sicurezza

• Usa chiavi SSH e non condividere credenziali.
• Evita comandi distruttivi.
• Conserva export e backup fuori dalle directory pubbliche.
• Controlla sito, wp-admin, moduli e log.
• Se non conosci l’ambito del comando, fermati e chiedi supporto.