L’interfaccia a riga di comando per WordPress

BY admin
|

WP-CLI è l’interfaccia a riga di comando per WordPress. È possibile aggiornare i plugin, configurare installazioni multisito e molto altro, senza utilizzare un browser web.

La manutenzione continua è resa possibile da:

L’attuale versione stabile è la versione 2.4.0. Per gli annunci, seguire @ wpcli su Twitter o registrarsi per gli aggiornamenti via email. Controlla la tabella di marcia per una panoramica di ciò che è previsto per le prossime uscite.

Stato di compilazione Tempo medio per risolvere un problema Percentuale di problemi ancora aperti

Collegamenti rapidi: Utilizzo | Installazione | Supporto | Estensione | Contributo | Crediti

Utilizzo di

WP-CLI fornisce un’interfaccia a riga di comando per molte azioni potresti eseguire nell’amministratore di WordPress. Ad esempio, wp plugin install --activate (doc) consente di installare e attivare un plugin per WordPress:

$ wp plugin install user-switching --activateInstalling User Switching (1.0.9)Downloading installation package from https://downloads.wordpress.org/plugin/user-switching.1.0.9.zip...Unpacking the package...Installing the plugin...Plugin installed successfully.Activating 'user-switching'...Plugin 'user-switching' activated.Success: Installed 1 of 1 plugins.

WP-CLI include anche comandi per molte cose che non puoi fare nell’amministratore di WordPress. Ad esempio, wp transient delete --all (doc) consente di eliminare uno o tutti i transienti:

$ wp transient delete --allSuccess: 34 transients deleted from the database.

Per un’introduzione più completa all’utilizzo di WP-CLI, leggere la guida rapida. Oppure, recuperare il ritardo con gli amici shell per conoscere utili utilità della riga di comando.

Già sentirsi a proprio agio con le basi? Salta nell’elenco completo dei comandi per informazioni dettagliate sulla gestione di temi e plugin, importazione ed esportazione di dati, esecuzione di operazioni di ricerca-sostituzione del database e altro ancora.

Installazione

Scaricare il file Phar è il nostro metodo di installazione consigliato per la maggior parte degli utenti. Se necessario, vedere anche la nostra documentazione sui metodi di installazione alternativi (Composer, Homebrew, Docker).

Prima di installare WP-CLI, assicurarsi che l’ambiente soddisfi i requisiti minimi:

  • Ambiente simile a UNIX (OS X, Linux, FreeBSD, Cygwin); supporto limitato in ambiente Windows
  • PHP 5.6 o successivo
  • WordPress 3.7 o successivo. Le versioni precedenti all’ultima versione di WordPress potrebbero avere funzionalità degradate

Una volta verificati i requisiti, scaricare wp-cli.phar file utilizzando wget o curl:

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

successivamente, controllare il Georgiano file per verificare che tutto funzioni:

php wp-cli.phar --info

Per utilizzare WP-CLI da riga di comando digitando wp, rendere eseguibile il file e spostarlo da qualche parte nel tuo PERCORSO. Ad esempio:

chmod +x wp-cli.pharsudo mv wp-cli.phar /usr/local/bin/wp

Se WP-CLI è stato installato correttamente, dovresti vedere qualcosa di simile quando esegui wp --info:

$ wp --infoOS:Darwin 16.7.0 Darwin Kernel Version 16.7.0: Thu Jan 11 22:59:40 PST 2018; root:xnu-3789.73.8~1/RELEASE_X86_64 x86_64Shell:/bin/zshPHP binary: /usr/local/bin/phpPHP version: 7.0.22php.ini used: /etc/local/etc/php/7.0/php.iniWP-CLI root dir: /home/wp-cli/.wp-cli/vendor/wp-cli/wp-cliWP-CLI vendor dir: /home/wp-cli/.wp-cli/vendorWP-CLI packages dir: /home/wp-cli/.wp-cli/packages/WP-CLI global config: /home/wp-cli/.wp-cli/config.ymlWP-CLI project config:WP-CLI version: 2.4.0

Aggiornamento

È possibile aggiornare WP-CLI con wp cli update (doc) o ripetendo i passaggi di installazione.

Se WP-CLI è di proprietà di root o di un altro utente di sistema, è necessario eseguire sudo wp cli update.

Vuoi vivere la vita al limite? Esegui wp cli update --nightly per utilizzare l’ultima build notturna di WP-CLI. La build nightly è più o meno abbastanza stabile da poter essere utilizzata nel proprio ambiente di sviluppo e include sempre le funzionalità WP-CLI più recenti e più avanzate.

Scheda completamenti

WP-CLI viene fornito con uno script di completamento scheda per Bash e ZSH. Basta scaricare wp-completamento.bash e fonte da ~/.bash_profile:

source /FULL/PATH/TO/wp-completion.bash

Non dimenticare di eseguire source ~/.bash_profile in seguito.

Se si utilizza zsh per la shell, potrebbe essere necessario caricare e avviare bashcompinit prima del sourcing. Metti quanto segue nel tuo .zshrc:

autoload bashcompinitbashcompinitsource /FULL/PATH/TO/wp-completion.bash

Supporto

I manutentori e i collaboratori di WP-CLI hanno una disponibilità limitata per rispondere a domande di supporto generali. La versione corrente di WP-CLI è l’unica versione ufficialmente supportata.

Quando alla ricerca di un sostegno, si prega di ricerca per la tua domanda in questi luoghi:

  • I problemi più comuni e le loro correzioni
  • WP-CLI manuale
  • Aperta o chiusa problemi in WP-CLI GitHub organizzazione
  • discussioni etichettate ‘WP-CLI’ in WordPress.org forum di supporto
  • Domande tagged ‘WP-CLI’ in WordPress StackExchange

Se non hai trovato la risposta in una delle sedi di cui sopra, è possibile:

  • Unire il #cli canale WordPress.org il margine di flessibilità per chattare con chiunque potrebbe essere disponibile al momento. Questa opzione è la migliore per domande veloci.
  • Pubblica un nuovo thread nel WordPress.org forum di supporto e tag ‘WP-CLI’ in modo che sia visto dalla comunità.

I problemi GitHub sono pensati per monitorare i miglioramenti e i bug dei comandi esistenti, non il supporto generale. Prima di inviare una segnalazione di bug, consulta le nostre best practice per assicurarti che il tuo problema venga risolto in modo tempestivo.

Si prega di non fare domande di supporto su Twitter. Twitter non è un luogo accettabile per il supporto perché: 1) è difficile tenere conversazioni in meno di 280 caratteri e 2) Twitter non è un luogo in cui qualcuno con la tua stessa domanda può cercare una risposta in una conversazione precedente.

Ricorda, libre != gratis; la licenza open source ti concede la libertà di usare e modificare, ma non gli impegni del tempo altrui. Si prega di essere rispettoso, e impostare le vostre aspettative di conseguenza.

Estensione

Un comando è l’unità atomica della funzionalità WP-CLI. wp plugin install (doc) è un comando. wp plugin activate (doc) è un altro.

WP-CLI supporta la registrazione di qualsiasi classe, funzione o chiusura chiamabile come comando. Legge i dettagli di utilizzo dal PHPdoc del callback. WP_CLI::add_command() (doc) viene utilizzato sia per la registrazione di comandi interni che di terze parti.

/** * Delete an option from the database. * * Returns an error if the option didn't exist. * * ## OPTIONS * * <key> * : Key for the option. * * ## EXAMPLES * * $ wp option delete my_option * Success: Deleted 'my_option' option. */$delete_option_cmd = function( $args ) {list( $key ) = $args;if ( ! delete_option( $key ) ) {WP_CLI::error( "Could not delete '$key' option. Does it exist?" );} else {WP_CLI::success( "Deleted '$key' option." );}};WP_CLI::add_command( 'option delete', $delete_option_cmd );

WP-CLI è dotato di decine di comandi. È più facile di quanto sembri creare un comando WP-CLI personalizzato. Leggi il libro di cucina dei comandi per saperne di più. Sfoglia i documenti API interni per scoprire una varietà di funzioni utili che è possibile utilizzare nel comando WP-CLI personalizzato.

Contributo

Apprezziamo che tu abbia preso l’iniziativa di contribuire a WP-CLI. È grazie a te, e alla comunità che ti circonda, che WP-CLI è un progetto così grande.

Contribuire non è limitato al solo codice. Ti invitiamo a contribuire nel modo che meglio si adatta alle tue capacità, scrivendo tutorial, dando una demo al tuo meetup locale, aiutando altri utenti con le loro domande di supporto o rivedendo la nostra documentazione.

Leggi le nostre linee guida nel manuale per un’introduzione approfondita su come puoi essere coinvolto. Seguendo queste linee guida aiuta a comunicare che si rispetta il tempo di altri collaboratori sul progetto. A loro volta, faranno del loro meglio per ricambiare quel rispetto quando lavorano con te, attraverso i fusi orari e in tutto il mondo.

Leadership

WP-CLI ha un responsabile del progetto: schlessera.

Occasionalmente, concediamo l’accesso in scrittura a contributori che hanno dimostrato, per un periodo di tempo, di essere capaci e investiti nel portare avanti il progetto.

Leggere il documento di governance nel manuale per ulteriori dettagli operativi sul progetto.

Crediti

Oltre alle librerie definite in composer.json, abbiamo utilizzato il codice di idee (o i seguenti progetti:

  • Drush per… un sacco di cose
  • wpshell per wp shell
  • Rigenerare le Miniature per wp media regenerate
  • Cerca-Sostituisci-DB per wp search-replace
  • WordPress-CLI-Esportatore per wp export
  • WordPress-CLI-Importatore per l’ wp import
  • wordpress-plugin-test per wp scaffold plugin-tests