Komentoriviliitäntä WordPress

WP-CLI on Komentoriviliitäntä WordPress. Voit päivittää liitännäisiä, määrittää multisite-asennuksia ja paljon muuta ilman verkkoselainta.

jatkuva kunnossapito on mahdollista:

nykyinen vakaa julkaisu on versio 2.4.0. Ilmoitukset, Seuraa @wpcli Twitterissä tai tilaa sähköpostipäivitykset. Tutustu etenemissuunnitelmaan saadaksesi yleiskuvan tulevista julkaisuista.

Build Status keskimääräinen aika ratkaista ongelma prosenttiosuus vielä auki olevista asioista

Pikalinkit: käyttämällä | asentamalla | Support | Extending | Contributing | Credits

käyttämällä

WP-CLI tarjoaa komentoriviliittymän monille toiminnoille saatat suorittaa WordPress admin. Esimerkiksi, wp plugin install --activate (doc) voit asentaa ja aktivoida WordPress plugin:

$ 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 sisältää myös komentoja monia asioita et voi tehdä WordPress admin. Esimerkiksi wp transient delete --all (doc) voit poistaa yhden tai kaikki transientit:

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

saat täydellisemmän johdannon WP-CLI: n käyttöön, Lue pikaopas. Tai, kiinni shell ystäviä oppia hyödyllisiä komentorivin apuohjelmia.

Tunnetko jo perusasiat? Hyppää täydellinen luettelo komentoja yksityiskohtaista tietoa hallintaan teemoja ja plugins, tuonti ja vienti tietoja, suorittaa tietokantahaku-korvaa toimintoja ja enemmän.

asentaminen

Phar-tiedoston lataaminen on suositeltava asennustapamme useimmille käyttäjille. Jos tarvitset, Katso myös dokumentaatio vaihtoehtoisista asennustavoista (Composer, Homebrew, Docker).

ennen kuin asennat WP-CLI: n, varmista, että ympäristösi täyttää vähimmäisvaatimukset:

  • Unixin kaltainen ympäristö (OS X, Linux, FreeBSD, Cygwin); rajoitettu tuki Windows-ympäristössä
  • PHP 5.6 tai uudempi
  • WordPress 3.7 tai uudempi. Viimeisintä WordPress-julkaisua vanhemmissa versioissa voi olla huonontunut toiminnallisuus

kun olet tarkistanut vaatimukset, lataa WP-cli.phar-tiedosto käyttäen wget tai curl:

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

Seuraava, tarkista Phar-tiedosto tarkistaa, että se toimii:

php wp-cli.phar --info

jos haluat käyttää WP-CLI: tä komentoriviltä kirjoittamalla wp, tee tiedosto suoritettavaksi ja siirrä se johonkin polkusi kohtaan. Esimerkiksi:

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

jos WP-CLI asennettiin onnistuneesti, sinun pitäisi nähdä jotain tällaista, kun suoritat 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

päivittäminen

voit päivittää WP-CLI: n kanssa wp cli update (doc) tai toistamalla asennusvaiheet.

jos WP-CLI on root: n tai muun järjestelmän käyttäjän omistuksessa, sinun on ajettava sudo wp cli update.

Haluatko elää elämää reunalla? Aja wp cli update --nightly käyttääksesi WP-CLI: n uusinta nightly-versiota. Nightly build on enemmän tai vähemmän vakaa, jotta voit käyttää kehitysympäristössäsi, ja se sisältää aina uusimmat ja suurimmat WP-CLI-ominaisuudet.

Tab completions

WP-CLI: n mukana tulee myös Bashin ja ZSH: n tab completion script. Vain ladata wp-loppuun.bash ja lähde se ~/.bash_profile:

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

älä unohda juosta source ~/.bash_profile jälkeenpäin.

jos käytät zsh: ta komentotulkkiisi, voit joutua lataamaan ja käynnistämään bashcompinit ennen hankintaa. Laita seuraava .zshrc:

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

tuki

WP-CLI: n ylläpitäjillä ja avustajilla on rajallinen saatavuus käsitellä yleisiä tukikysymyksiä. Nykyinen versio WP-CLI on ainoa virallisesti tuettu versio.

kun etsit tukea, etsi kysymyksesi ensin näistä paikoista:

  • yhteiset asiat ja niiden korjaukset
  • WP-CLI-käsikirja
  • WP-CLI-GitHub-organisaation avoimet tai suljetut kysymykset
  • kierteet merkitty ”WP-CLI” WordPress.org support forum
  • Questions tagged’ WP-CLI ’in the WordPress StackExchange

If you didn’ t find an answer in one of the venues above, you can:

  • liity #cli kanavaan WordPress.org löysää keskustella kenen tahansa kanssa, joka voi olla käytettävissä sillä hetkellä. Tämä vaihtoehto on paras nopeisiin kysymyksiin.
  • Lähetä uusi säie WordPress.org tuki foorumi ja tag se ’WP-CLI’ niin se on nähnyt yhteisön.

GitHub-ongelmat on tarkoitettu olemassa olevien komentojen parannusten ja vikojen seurantaan, ei yleiseen tukeen. Ennen vikailmoituksen lähettämistä tutustu parhaisiin käytäntöihimme varmistaaksesi, että ongelmaasi puututaan ajoissa.

Älä kysy tukikysymyksiä Twitterissä. Twitter ei ole hyväksyttävä paikka tukea, koska: 1) on vaikea pitää keskusteluja alle 280 merkkiä, ja 2) Twitter ei ole paikka, jossa joku, jolla on sama kysymys, voi etsiä vastausta aiemmassa keskustelussa.

Remember, libre != ilmainen; avoimen lähdekoodin lisenssi antaa sinulle vapauden käyttää ja muokata, mutta ei sitoumuksia muiden ihmisten aikaa. Ole kunnioittava ja aseta odotuksesi sen mukaan.

ulottuva

a-komento on WP-CLI-toiminnallisuuden atomiyksikkö. wp plugin install (doc) on yksi komento. wp plugin activate (doc) on toinen.

WP-CLI tukee minkä tahansa kutsuttavan luokan, funktion tai sulkemisen rekisteröimistä käskyksi. Se lukee käyttötiedot callback n PHPdoc. WP_CLI::add_command() (doc) käytetään sekä sisäiseen että kolmannen osapuolen komentorekisteröintiin.

/** * 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 sisältää kymmeniä komentoja. Mukautetun WP-CLI-komennon luominen on helpompaa kuin miltä näyttää. Lue lisää komentojen keittokirjasta. Selaa sisäisiä API-dokumentteja löytääksesi erilaisia hyödyllisiä toimintoja, joita voit käyttää mukautetussa WP-CLI-komennossa.

osallistuminen

arvostamme aloitettasi osallistua WP-CLI: n toimintaan. Sinun ja ympäröivän yhteisön ansiosta WP-CLI on niin hieno projekti.

osallistuminen ei rajoitu pelkkään koodaamiseen. Kannustamme sinua osallistumaan tavalla, joka parhaiten sopii kykyihisi, kirjoittamalla tutorials, antamalla demo paikallisessa meetup, auttaa muita käyttäjiä heidän tukikysymykset, tai tarkistamalla dokumentaatiota.

lukekaa käsikirjasta lisäohjeet, joissa on perusteellinen johdatus siihen, miten voit osallistua. Näiden ohjeiden noudattaminen auttaa viestimään, että kunnioitat muiden projektiin osallistuneiden aikaa. He puolestaan tekevät parhaansa vastatakseen tuohon kunnioitukseen työskennellessään kanssasi, aikavyöhykkeillä ja ympäri maailmaa.

Leadership

WP-CLI: llä on yksi projektin ylläpitäjä: schlessera.

toisinaan annamme kirjoitusoikeuden avustajille, jotka ovat osoittaneet jonkin ajan kuluessa pystyvänsä viemään hanketta eteenpäin ja panostavansa siihen.

Lue ohjekäsikirjasta lisätietoja hankkeesta.

ov

säveltäjässä määriteltyjen kirjastojen lisäksi.json, olemme käyttäneet koodia tai ideoita seuraavista projekteista:

  • Drush for … a lot of things
  • wpshell for wp shell
  • Regenerate Thumbnails for wp media regenerate
  • Search-Replace-DB for wp search-replace
  • WordPress-CLI-Exporter for wp export
  • WordPress-CLI-Importer for wp import
  • WordPress-plugin-testit wp scaffold plugin-tests