WP-CLI è l'interfaccia a riga di comando di WordPress ed è uno degli strumenti più potenti nell'arsenale di uno sviluppatore WordPress. Ti permette di gestire le installazioni, eseguire aggiornamenti, generare codice, eseguire test e automatizzare i deployment — tutto dal terminale. Se non usi WP-CLI nel tuo workflow di sviluppo, stai lavorando più del necessario.
Questa guida copre come WP-CLI può accelerare il tuo workflow di sviluppo plugin, dallo scaffolding al testing fino all'automazione delle release.
Installare e Configurare WP-CLI
WP-CLI viene installato tramite un file Phar o un gestore di pacchetti. Scaricalo da wp-cli.org, rendilo eseguibile e spostalo nel tuo PATH. Sulla maggior parte dei sistemi, ci vuole meno di un minuto. Verifica l'installazione con wp --info, che mostra la versione e il percorso della tua installazione WordPress. Crea un file wp-cli.yml nella radice del progetto per definire le impostazioni predefinite come il percorso di WordPress e le credenziali del database.
Scaffolding di Plugin e Block
I comandi scaffold di WP-CLI generano strutture di codice complete e funzionanti. wp scaffold plugin crea una directory plugin con il file principale, il readme e la struttura di base. wp scaffold block crea un block Gutenberg con tutti i file necessari. Questi comandi di scaffolding fanno risparmiare ore di configurazione manuale e seguono gli standard di codifica WordPress.
Gestire gli Ambienti di Sviluppo
WP-CLI semplifica la gestione dell'ambiente locale. Usa wp db create per configurare un database, wp core download per scaricare WordPress e wp core install per eseguire la procedura guidata di installazione dalla riga di comando. Per lo sviluppo multisite, usa wp site create per aggiungere nuovi siti, tutto senza caricare l'interfaccia admin di WordPress.
Test e Debugging
WP-CLI si integra con PHPUnit per eseguire i test. Usa wp scaffold plugin-tests per generare il boilerplate della suite di test. Per il debugging, usa wp db query per eseguire SQL direttamente, wp post list per ispezionare i contenuti e wp option get per esaminare le opzioni WordPress. Questi comandi danno accesso diretto ai tuoi dati senza scrivere codice PHP.
Automatizzare i Compiti Ripetitivi
Il vero potere di WP-CLI è nell'automazione. Scrivi script di shell che combinano più comandi per automatizzare i workflow comuni. Uno script di deployment potrebbe eseguire i test, generare un file POT, compilare gli asset, creare una release GitHub e pubblicare su WordPress.org con un solo comando. Usa cron per pianificare le attività di manutenzione regolari.
Comandi WP-CLI Personalizzati
Puoi aggiungere comandi personalizzati a WP-CLI per le esigenze specifiche del tuo plugin. Crea una classe di comando che estende WP_CLI_Command, definisci i metodi per ogni sottocomando e registrala con WP_CLI::add_command(). I comandi personalizzati danno ai tuoi utenti un'interfaccia a riga di comando per le funzionalità del plugin, preziosa per gli utenti avanzati e i deployment automatizzati.
Il punto fondamentale
WP-CLI trasforma il modo in cui sviluppi, testi e pubblichi i plugin WordPress. Converte i processi manuali in più passaggi in singoli comandi, elimina il lavoro ripetitivo e apre possibilità di automazione che non sono possibili tramite l'admin WordPress. Se costruisci plugin professionalmente, WP-CLI non è opzionale — è essenziale.
