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