kommandolinjegrænsefladen til ordtryk

BY admin
|

kommandolinjegrænsefladen er kommandolinjegrænsefladen til ordtryk. Du kan opdatere plugins, konfigurere multisite-installationer og meget mere uden at bruge en internetsøgemaskine.

løbende vedligeholdelse er muliggjort af:

den nuværende stabile udgave er version 2.4.0. For meddelelser, Følg @ på kvidre eller tilmelde dig e-mail-opdateringer. Tjek køreplanen for en oversigt over, hvad der er planlagt til kommende udgivelser.

Build Status gennemsnitlig tid til at løse et problem procentdel af problemer, der stadig er åbne

hurtige links: brug | installation | Support | udvidelse | Bidrag | kreditter

brug af

du kan udføre i admin. wp plugin install --activate (doc) giver dig mulighed for at installere og aktivere et 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.

CLI indeholder også kommandoer til mange ting, du ikke kan gøre i admin. For eksempel wp transient delete --all (doc) lader dig slette en eller alle transienter:

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

For en mere komplet introduktion til brug af CLI, Læs Hurtigstartguiden. Eller indhent shell-venner for at lære om nyttige kommandolinjeværktøjer.

føler du dig allerede godt tilpas med det grundlæggende? Gå ind i den komplette liste over kommandoer for detaljerede oplysninger om styring af temaer og plugins, import og eksport af data, udførelse af databasesøgning-udskift operationer og mere.

installation

hentning af Phar-filen er vores anbefalede installationsmetode for de fleste brugere. Hvis du har brug for det, se også vores dokumentation om alternative installationsmetoder (komponist, hjemmebryggeri, Docker).

sørg for, at dit miljø opfylder minimumskravene, før du installerer CLI:

  • begrænset støtte i vinduer miljø
  • PHP 5.6 eller nyere
  • ordtryk 3.7 eller nyere. Versioner, der er ældre end den seneste udgivelse, kan have forringet funktionalitet

når du har bekræftet kravene, skal du hente den.phar-fil ved hjælp af wget eller curl:

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

kontroller derefter Phar-filen for at kontrollere, at den fungerer:

php wp-cli.phar --info

hvis du vil bruge VP-CLI fra kommandolinjen ved at skrive wp, skal du gøre filen eksekverbar og flytte den til et sted i din sti. For eksempel:

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

hvis CLI blev installeret korrekt, skal du se noget som dette, når du kø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

opdatering

du kan opdatere CLI med wp cli update (doc) eller ved at gentage installationstrinnene.

hvis ejes af root eller en anden systembruger, skal du køre sudo wp cli update.

vil du leve livet på kanten? Kør wp cli update --nightly for at bruge den seneste natlige opbygning af VP-CLI. Den natlige opbygning er mere eller mindre stabil nok til at du kan bruge i dit udviklingsmiljø, og indeholder altid de nyeste og bedste funktioner.

fuldførelse af fanebladet

VP-CLI leveres også med et faneblad fuldførelsesscript for Bash og SSH. Bare hent AP-færdiggørelse.bash og kilde det fra ~/.bash_profile:

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

glem ikke at køre source ~/.bash_profile bagefter.

hvis du bruger SSH til din shell, skal du muligvis indlæse og starte bashcompinit før sourcing. Sæt følgende i din .zshrc:

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

Support

VP-CLI ‘ s vedligeholdere og bidragydere har begrænset tilgængelighed til at løse generelle supportspørgsmål. Den nuværende version af CLI er den eneste officielt understøttede version.

når du leder efter support, skal du først søge efter dit spørgsmål på disse spillesteder:

  • almindelige problemer og deres rettelser
  • håndbog
  • åbne eller lukkede problemer i GitHub-organisationen
  • tråde tagget ‘VP-CLI’ i WordPress.org support forum
  • spørgsmål tagget’ VP-CLI ‘ i Stackudvekslingen

hvis du ikke fandt et svar på et af stederne ovenfor, kan du:

  • Deltag i #cli kanalen i WordPress.org slap for at chatte med hvem der måtte være tilgængelig på det tidspunkt. Denne mulighed er bedst til hurtige spørgsmål.
  • Skriv en ny tråd i WordPress.org support forum og tag det ‘VP-CLI’, så det ses af samfundet.

GitHub-problemer er beregnet til sporing af forbedringer til og fejl i eksisterende kommandoer, ikke generel support. Før du sender en fejlrapport, skal du gennemgå vores bedste praksis for at sikre, at dit problem løses rettidigt.

vær venlig ikke at stille support spørgsmål på kvidre. Kvidre er ikke et acceptabelt sted for støtte, fordi: 1) Det er svært at holde samtaler i under 280 tegn, og 2) kvidre er ikke et sted, hvor en person med dit samme spørgsmål kan søge efter et svar i en tidligere samtale.

husk, libre != gratis; open source-licensen giver dig frihed til at bruge og ændre, men ikke forpligtelser fra andres tid. Vær respektfuld, og sæt dine forventninger i overensstemmelse hermed.

udvidelse

en kommando er den atomare enhed af CLI-funktionalitet. wp plugin install (doc) er en kommando. wp plugin activate (doc) er en anden.

CLI understøtter registrering af enhver klasse, funktion eller lukning, der kan kaldes, som en kommando. Det læser brugsoplysninger fra tilbagekaldets PHPdoc. WP_CLI::add_command() (doc) bruges 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 );

VP-CLI kommer med snesevis af kommandoer. Det er nemmere end det ser ud til at oprette en brugerdefineret kommando. Læs kommandokogebogen for at lære mere. Gennemse de interne API-dokumenter for at finde en række nyttige funktioner, du kan bruge i din brugerdefinerede kommando.

Bidrag

vi sætter pris på, at du tager initiativ til at bidrage til CLI. Det er på grund af dig og samfundet omkring dig, at CLI er et så godt projekt.

bidrag er ikke begrænset til kun kode. Vi opfordrer dig til at bidrage på den måde, der bedst passer til dine evner, ved at skrive tutorials, give en demo på dit lokale møde, hjælpe andre brugere med deres supportspørgsmål, eller revidere vores dokumentation.

læs vores bidragende retningslinjer i håndbogen for en grundig introduktion til, hvordan du kan blive involveret. At følge disse retningslinjer hjælper med at kommunikere, at du respekterer tidspunktet for andre bidragydere på projektet. Til gengæld vil de gøre deres bedste for at gengælde den respekt, når de arbejder sammen med dig, på tværs af tider og rundt om i verden.

Ledelse

VP-CLI har et projekt vedligeholder: schlessera.

lejlighedsvis giver vi skriveadgang til bidragydere, der over en periode har demonstreret, at de er i stand til og investeret i at bevæge projektet fremad.

Læs styringsdokumentet i håndbogen for at få flere operationelle detaljer om projektet.

kreditter

udover bibliotekerne defineret I komponist.json, vi har brugt kode eller ideer fra følgende projekter:

  • Drush for… en masse ting
  • vpshell for wp shell
  • regenerere Thumbnails for wp media regenerate
  • Søg-Erstat-DB for wp search-replace
  • Vpress-CLI-eksportør for wp export
  • Vpress-CLI-importør for wp export
  • wp import
  • test for wp scaffold plugin-tests