interfața linie de comandă pentru WordPress

BY admin
|

WP-CLI este interfața linie de comandă pentru WordPress. Puteți actualiza pluginurile, configura instalările multisite și multe altele, fără a utiliza un browser web.

întreținerea continuă este posibilă prin:

versiunea stabilă actuală este versiunea 2.4.0. Pentru anunțuri, urmați @wpcli pe Twitter sau înscrieți-vă pentru actualizări prin e-mail. Consultați foaia de parcurs pentru o prezentare generală a ceea ce este planificat pentru versiunile viitoare.

Build stare timpul mediu pentru a rezolva o problemă procentul de probleme încă deschise

link-uri rapide: utilizarea | instalarea | suport | extinderea | Contribuirea | credite

utilizarea

WP-CLI oferă o interfață de linie de comandă pentru mai multe acțiuni s-ar putea efectua în WordPress admin. De exemplu, wp plugin install --activate (doc) vă permite să instalați și să activați un plugin 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, de asemenea, comenzi pentru multe lucruri pe care nu le puteți face în administratorul WordPress. De exemplu, wp transient delete --all (doc) vă permite să ștergeți unul sau toate tranzitorii:

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

pentru o introducere mai completă a utilizării WP-CLI, citiți ghidul de pornire rapidă. Sau, prindeți-vă cu prietenii shell pentru a afla despre utilitățile utile ale liniei de comandă.

deja se simt confortabil cu elementele de bază? Salt în lista completă de comenzi pentru informații detaliate cu privire la gestionarea teme și plugin-uri, importul și exportul de date, efectuarea de căutare de baze de date-înlocuiți operațiunile și mai mult.

instalarea

descărcarea fișierului Phar este metoda noastră de instalare recomandată pentru majoritatea utilizatorilor. Dacă aveți nevoie, consultați și documentația noastră privind metodele alternative de instalare (Composer, Homebrew, Docker).

înainte de a instala WP-CLI, asigurați-vă că mediul dvs. îndeplinește cerințele minime:

  • mediu de tip UNIX (OS X, Linux, FreeBSD, Cygwin); suport limitat în mediul Windows
  • PHP 5.6 sau o versiune ulterioară
  • WordPress 3.7 sau o versiune ulterioară. Versiunile mai vechi decât cea mai recentă versiune WordPress pot avea funcționalitate degradată

după ce ați verificat cerințele, descărcați wp-cli.fișier phar folosind wget sau curl:

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

apoi, verificați fișierul Phar pentru a verifica dacă funcționează:

php wp-cli.phar --info

pentru a utiliza WP-CLI din linia de comandă tastând wp, faceți fișierul executabil și mutați-l undeva în calea dvs. De exemplu:

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

dacă WP-CLI a fost instalat cu succes, ar trebui să vedeți ceva de genul asta atunci când executați 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

actualizarea

puteți actualiza WP-CLI cu wp cli update (doc) sau repetând pașii de instalare.

dacă WP-CLI este deținut de root sau de un alt utilizator de sistem, va trebui să rulați sudo wp cli update.

vrei să trăiești viața pe margine? Rulați wp cli update --nightly pentru a utiliza cea mai recentă versiune nocturnă a WP-CLI. Construcția nocturnă este suficient de mult sau mai puțin stabilă pentru a putea fi utilizată în mediul dvs. de dezvoltare și include întotdeauna cele mai recente și mai bune caracteristici WP-CLI.

completări Tab

WP-CLI, de asemenea, vine cu un script de completare tab pentru Bash și ZSH. Doar descărca WP-finalizare.bash și sursa de la ~/.bash_profile:

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

nu uitați să rulați source ~/.bash_profile după aceea.

dacă utilizați zsh pentru shell, poate fi necesar să încărcați și să începeți bashcompinit înainte de aprovizionare. Puneți următoarele în .zshrc:

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

suport

întreținătorii și colaboratorii WP-CLI au disponibilitate limitată pentru a răspunde întrebărilor generale de asistență. Versiunea curentă a WP-CLI este singura versiune acceptată oficial.

când căutați asistență, vă rugăm să căutați mai întâi întrebarea dvs. în aceste locuri:

  • probleme comune și remedierile lor
  • manual WP-CLI
  • Probleme deschise sau închise în Organizația GitHub WP-CLI
  • Fire etichetate ‘WP-CLI’ în WordPress.org forum de asistență
  • întrebări etichetate ‘WP-CLI’ în WordPress StackExchange

dacă nu ați găsit un răspuns într-unul din locurile de mai sus, puteți:

  • Alăturați-vă canalului #cli în WordPress.org Slack pentru a discuta cu oricine ar putea fi disponibil la momentul respectiv. Această opțiune este cea mai bună pentru întrebări rapide.
  • Postează un fir nou în WordPress.org forum de sprijin și etichetați-l ‘WP-CLI’, astfel încât este văzut de comunitate.

problemele GitHub sunt destinate urmăririi îmbunătățirilor și erorilor comenzilor existente, nu suportului general. Înainte de a trimite un raport de eroare, vă rugăm să consultați cele mai bune practici pentru a vă asigura că problema dvs. este abordată în timp util.

vă rugăm să nu puneți întrebări de asistență pe Twitter. Twitter nu este un loc acceptabil pentru sprijin, deoarece: 1) este greu să ții conversații în sub 280 de caractere și 2) Twitter nu este un loc în care cineva cu aceeași întrebare poate căuta un răspuns într-o conversație anterioară.

Amintește-ți, libre != gratis; Licența open source vă acordă libertatea de a utiliza și modifica, dar nu și angajamentele din timpul altor persoane. Vă rugăm să fiți respectuoși și să vă stabiliți așteptările în consecință.

extinzând

o comandă este unitatea atomică a funcționalității WP-CLI. wp plugin install (doc) este o singură comandă. wp plugin activate(doc) este altul.

WP-CLI acceptă înregistrarea oricărei clase, funcții sau închideri apelabile ca comandă. Se citește detalii de utilizare de la phpdoc apel invers lui. WP_CLI::add_command() (doc) este utilizat atât pentru înregistrarea comenzilor interne, cât și pentru terțe părți.

/** * 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 vine cu zeci de comenzi. Este mai ușor decât pare să creați o comandă WP-CLI personalizată. Citiți comenzile carte de bucate pentru a afla mai multe. Răsfoiți documentele API interne pentru a descoperi o varietate de funcții utile pe care le puteți utiliza în comanda personalizată WP-CLI.

Contribuirea

apreciem că ați luat inițiativa de a contribui la WP-CLI. Datorită ție și comunității din jurul tău, WP-CLI este un proiect atât de grozav.

contribuția nu se limitează doar la cod. Vă încurajăm să contribuiți în modul care se potrivește cel mai bine abilităților dvs., scriind tutoriale, oferind o demonstrație la întâlnirea locală, ajutând alți utilizatori cu întrebările lor de asistență sau revizuind documentația noastră.

citiți ghidul nostru din manual pentru o introducere detaliată a modului în care vă puteți implica. Respectarea acestor instrucțiuni vă ajută să comunicați că respectați timpul altor contribuitori la proiect. La rândul lor, vor face tot posibilul pentru a-și răsplăti acest respect atunci când lucrează cu dvs., în zonele de fus orar și în întreaga lume.

Leadership

WP-CLI are un singur responsabil de proiect: schlessera.

ocazional, acordăm acces la scriere contribuitorilor care au demonstrat, pe o perioadă de timp, că sunt capabili și investiți în avansarea proiectului.

citiți documentul de guvernare din manual pentru mai multe detalii operaționale despre proiect.

credite

pe lângă bibliotecile definite în composer.json, am folosit cod sau idei din următoarele proiecte:

  • Drush pentru… o mulțime de lucruri
  • wpshell pentru wp shell
  • regenera miniaturi pentru wp media regenerate
  • căutare-înlocuiți-DB pentru wp search-replace
  • WordPress-CLI-exportator pentru wp export
  • WordPress-CLI-importator pentru wp import
  • wordpress-plugin-teste pentru wp scaffold plugin-tests