kommandolinjegrensesnittet For WordPress

WP-CLI ER kommandolinjegrensesnittet For WordPress. Du kan oppdatere plugins, konfigurere multisite installasjoner og mye mer, uten å bruke en nettleser.

Løpende vedlikehold er muliggjort av:

den nåværende stabile versjonen er versjon 2.4.0. For kunngjøringer, følg @ wpcli På Twitter eller registrer deg for e-postoppdateringer. Sjekk ut veikartet for en oversikt over hva som er planlagt for kommende utgivelser.

Byggstatus gjennomsnittlig tid for å løse et problem Prosentandel av problemer som fortsatt er åpne

Hurtigkoblinger: Bruke | Installere | Støtte | Utvide | Bidra | Kreditt

Bruke

WP-CLI gir et kommandolinjegrensesnitt for mange handlinger du kan utføre i wordpress admin. For eksempel, wp plugin install --activate (doc) lar deg installere Og aktivere En 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 inneholder også kommandoer for mange ting du ikke kan gjøre I WordPress admin. For eksempel kan wp transient delete --all (doc) du slette ett eller alle transienter:

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

for en mer komplett introduksjon TIL BRUK AV WP-CLI, les Hurtigstartveiledningen. Eller, ta opp med shell venner for å lære om nyttige kommandolinjeverktøy.

føler du deg allerede komfortabel med det grunnleggende? Gå inn i den komplette listen over kommandoer for detaljert informasjon om å administrere temaer og plugins, importere og eksportere data, utføre databasesøk-erstatt operasjoner og mer.

Installere

Nedlasting Av phar-filen er vår anbefalte installasjonsmetode for de fleste brukere. Hvis du trenger det, se også vår dokumentasjon på alternative installasjonsmetoder (Composer, Homebrew, Docker).

før du installerer WP-CLI, må du sørge for at miljøet oppfyller minimumskravene:

  • UNIX-lignende miljø (OS X, Linux, FreeBSD, Cygwin); begrenset støtte I Windows-miljø
  • PHP 5.6 eller nyere
  • WordPress 3.7 eller nyere. Versjoner eldre Enn Den nyeste WordPress-utgivelsen kan ha forringet funksjonalitet

når du har bekreftet kravene, last ned wp-cli.phar-fil ved hjelp av wget eller curl:

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

deretter sjekker Du phar-filen for å bekrefte at den fungerer:

php wp-cli.phar --info

for Å bruke WP-CLI fra kommandolinjen ved å skrive wp, gjør filen kjørbar og flytt den til et sted i VEIEN. For eksempel:

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

HVIS WP-CLI ble installert, bør du se noe slikt når du kjører 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

Oppdatere

DU kan oppdatere WP-CLI med wp cli update (doc), eller ved å gjenta installasjonstrinnene.

HVIS WP-CLI eies av root eller en annen systembruker, må du kjøre sudo wp cli update.

Vil du leve livet på kanten? Kjør wp cli update --nightly for å bruke den nyeste nightly build AV WP-CLI. Den nattlige bygningen er mer eller mindre stabil nok til at du kan bruke i utviklingsmiljøet ditt, og inneholder alltid de nyeste OG beste wp-CLI-funksjonene.

tabulatorfullføringer

WP-CLI kommer også med et tabulatorfullføringsskript For Bash OG ZSH. Bare last ned wp-ferdigstillelse.bash og kilde det fra ~/.bash_profile:

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

Ikke glem å løpe source ~/.bash_profile etterpå.

hvis du bruker zsh for skallet ditt, må du kanskje laste og starte bashcompinit før du kjøper. Sett inn følgende i din .zshrc:

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

Support

wp-CLI ‘ s vedlikeholdere og bidragsytere har begrenset tilgjengelighet for å løse generelle støttespørsmål. Den nåværende versjonen AV WP-CLI er den eneste offisielt støttede versjonen.

når du ser etter støtte, må du først søke etter spørsmålet ditt på disse stedene:

  • Vanlige problemer og deres løsninger
  • wp-CLI handbook
  • Åpne eller lukkede problemer i Wp-CLI GitHub-organisasjonen
  • Tråder merket ‘WP-CLI’ i WordPress.org støtteforum
  • Spørsmål merket ‘WP-CLI’ I WordPress StackExchange

hvis du ikke fant svar på et av stedene ovenfor, kan du:

  • Bli med i #cli – kanalen i WordPress.org Slack å chatte med hvem som kan være tilgjengelig på det tidspunktet. Dette alternativet er best for raske spørsmål.
  • Legg inn en ny tråd i WordPress.org support forum og tag det ‘WP-CLI’ så det er sett av samfunnet.

GitHub-problemer er ment for å spore forbedringer og feil av eksisterende kommandoer, ikke generell støtte. Før du sender inn en feilrapport, bør du lese våre beste fremgangsmåter for å sikre at problemet løses i tide.

ikke still spørsmål om kundestøtte På Twitter. Twitter er ikke et akseptabelt sted for støtte fordi: 1) Det er vanskelig å holde samtaler på under 280 tegn, og 2) Twitter Er ikke et sted hvor noen med samme spørsmål kan søke etter svar i en tidligere samtale.

Husk, libre != gratis; open source-lisensen gir deg frihet til å bruke og endre, men ikke forpliktelser til andres tid. Vær respektfull, og sett dine forventninger tilsvarende.

Utvide

en kommando er atomenheten TIL wp-CLI-funksjonalitet. wp plugin install (doc) er en kommando. wp plugin activate (doc) er en annen.

wp-CLI støtter registrering av kallbar klasse, funksjon eller lukking som en kommando. Den leser bruksdetaljer fra tilbakeringingens PHPdoc. WP_CLI::add_command() (doc) brukes til både intern og tredjeparts kommandoregistrering.

/** * 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 kommer med dusinvis av kommandoer. Det er enklere enn det ser ut til å lage en tilpasset wp-CLI-kommando. Les kommandoer kokebok for å lære mer. Bla gjennom de interne API-dokumentene for å oppdage en rekke nyttige funksjoner du kan bruke i din egendefinerte wp-CLI-kommando.

Bidra

vi setter pris på at du tar initiativ TIL Å bidra TIL WP-CLI. DET er på grunn av deg, og samfunnet rundt DEG, AT WP-CLI er et flott prosjekt.

Bidrag er ikke begrenset til bare kode. Vi oppfordrer deg til å bidra på den måten som passer best til dine evner, ved å skrive opplæringsprogrammer, gi en demo på ditt lokale møte, hjelpe andre brukere med sine støttespørsmål eller revidere dokumentasjonen vår.

Les gjennom våre medvirkende retningslinjer i håndboken for en grundig innføring i hvordan du kan bli involvert. Å følge disse retningslinjene bidrar til å kommunisere at du respekterer tiden til andre bidragsytere på prosjektet. I sin tur vil de gjøre sitt beste for å gjengjelde den respekten når de jobber med deg, på tvers av tidssoner og rundt om i verden.

Ledelse

WP-CLI har ett prosjekt vedlikeholder: schlessera.

noen ganger gir vi skrivetilgang til bidragsytere som over en periode har vist at de er i stand til og investert i å flytte prosjektet fremover.

Les styringsdokumentet i håndboken for mer operasjonelle detaljer om prosjektet.

Studiepoeng

Foruten bibliotekene definert i komponist.json, vi har brukt kode eller ideer fra følgende prosjekter:

  • Drush for… mange ting
  • wpshell for wp shell
  • Regenerere Miniatyrbilder for wp media regenerate
  • Søk-Erstatt-DB for wp search-replace
  • WordPress-Cli-Eksportør for wp export
  • WordPress-Cli-Importør for wp import
  • wordpress-plugin-tester for wp scaffold plugin-tests