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.
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