rozhraní příkazového řádku pro WordPress

WP-CLI je rozhraní příkazového řádku pro WordPress. Můžete aktualizovat pluginy, konfigurovat vícemístné instalace a mnoho dalšího bez použití webového prohlížeče.

průběžná údržba je umožněna:

aktuální stabilní verze je verze 2.4.0. Pro oznámení Sledujte @wpcli na Twitteru nebo se zaregistrujte pro e-mailové aktualizace. Podívejte se na plán pro přehled toho, co je plánováno pro nadcházející vydání.

Status Průměrný čas na vyřešení problému, Procento z otázek, které je stále otevřené

Rychlé odkazy: Použití | Instalace | Support | Rozšíření | Přispívá | Kredity

Pomocí

WP-CLI poskytuje rozhraní příkazového řádku pro mnoho akcí, které můžete provádět v WordPress admin. Například, wp plugin install --activate (doc) vám umožní nainstalovat a aktivovat plugin WordPress:

$ 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 obsahuje také příkazy pro mnoho věcí, které můžete udělat v WordPress admin. Například wp transient delete --all (doc) umožňuje odstranit jeden nebo všechny přechodné jevy:

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

pro úplnější úvod do používání WP-CLI, přečtěte si Průvodce rychlým startem. Nebo dohnat s přáteli shell Se dozvědět o užitečné nástroje příkazového řádku.

už se cítíte pohodlně se základy? Skočte do úplného seznamu příkazů a získejte podrobné informace o správě témat a pluginů, importu a exportu dat, provádění operací vyhledávání v databázi a dalších.

instalace

stahování souboru Phar je pro většinu uživatelů doporučenou metodou instalace. Pokud potřebujete, podívejte se také na naši dokumentaci o alternativních způsobech instalace (Composer, Homebrew, Docker).

Před instalací WP-CLI, prosím, ujistěte se, že vaše prostředí splňuje minimální požadavky:

  • UNIX-like prostředí (OS X, Linux, FreeBSD, Cygwin); omezená podpora v prostředí Windows
  • PHP 5.6 nebo novější
  • WordPress 3.7 nebo novější. Verze starší než nejnovější verze WordPress mohou mít zhoršenou funkčnost

jakmile ověříte požadavky, stáhněte si WP-cli.phar soubor pomocí wget nebo curl:

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

Další, podívejte se na Phar soubor k ověření, že to funguje:

php wp-cli.phar --info

použití WP-CLI z příkazového řádku zadáním wp, aby spustitelný soubor a přesunout ho někam, kde v CESTĚ. Například:

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

pokud byl WP-CLI úspěšně nainstalován, měli byste vidět něco takového při spuštění 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

aktualizace

WP-CLI můžete aktualizovat pomocí wp cli update (doc) nebo opakováním instalačních kroků.

pokud je WP-CLI ve vlastnictví root nebo jiného uživatele systému, budete muset spustit sudo wp cli update.

chcete žít život na okraji? Spusťte wp cli update --nightly a použijte nejnovější noční sestavení WP-CLI. Noční sestavení je víceméně dostatečně stabilní pro použití ve vašem vývojovém prostředí a vždy obsahuje nejnovější a nejlepší funkce WP-CLI.

Tab completions

WP-CLI také přichází s tabulátorem dokončení skriptu pro Bash a ZSH. Stačí stáhnout WP-dokončení.bash a zdroj z ~/.bash_profile:

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

nezapomeňte spustit source ~/.bash_profile poté.

pokud používáte zsh pro svůj shell, možná budete muset načíst a spustit bashcompinit před získáním zdrojů. Vložte do svého .zshrc:

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

podpora

správci a přispěvatelé WP-CLI mají omezenou dostupnost pro řešení obecných otázek podpory. Aktuální verze WP-CLI je jedinou oficiálně podporovanou verzí.

Když hledám podporu, prosím nejprve vyhledat váš dotaz v těchto místech:

  • Běžné problémy a jejich opravy
  • WP-CLI příručka
  • Otevřené nebo uzavřené otázky v WP-CLI GitHub organizace
  • Threads tagged ‚WP-CLI‘ v WordPress.org support forum
  • Otázky, tagged ‚WP-CLI‘ v WordPress StackExchange

Pokud jste nenašli odpověď v jednom z míst výše, můžete:

  • Připojit se k #cli kanál v WordPress.org Slack chatovat s kýmkoli, kdo by mohl být k dispozici v té době. Tato možnost je nejlepší pro rychlé otázky.
  • vložte nové vlákno do WordPress.org Podporujte fórum a označte jej „WP-CLI“, takže ho komunita vidí.

problémy s Githubem jsou určeny pro sledování vylepšení a chyb existujících příkazů, nikoli pro obecnou podporu. Před odesláním hlášení o chybě, přečtěte si naše osvědčené postupy, které vám pomohou zajistit, aby byl váš problém vyřešen včas.

nepokládejte prosím otázky podpory na Twitteru. Twitter není přijatelným místem pro podporu, protože: 1) je těžké vést konverzace pod 280 znaky a 2) Twitter není místo, kde někdo s vaší stejnou otázkou může hledat odpověď v předchozí konverzaci.

Pamatuj, libre != gratis; open source licence vám poskytuje svobodu používat a upravovat, ale ne závazky času jiných lidí. Buďte prosím uctiví, a podle toho nastavte svá očekávání.

rozšíření

příkaz je atomová jednotka funkce WP-CLI. wp plugin install (doc) je jeden příkaz. wp plugin activate (doc) je další.

WP-CLI podporuje registraci libovolné volané třídy, funkce nebo uzavření jako příkaz. Čte podrobnosti o použití z PHPdoc zpětného volání. WP_CLI::add_command() (doc) se používá jak pro interní, tak pro registraci příkazů třetích stran.

/** * 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 přichází s desítkami příkazů. Je to jednodušší, než to vypadá vytvořit vlastní příkaz WP-CLI. Přečtěte si kuchařku příkazů a dozvíte se více. Procházejte interní dokumenty API a objevte řadu užitečných funkcí, které můžete použít ve svém vlastním příkazu WP-CLI.

Přispívající

vážíme si toho, že iniciativa přispět k WP-CLI. Je to kvůli vám a komunitě kolem vás, že WP-CLI je tak skvělý projekt.

přispívání není omezeno pouze na kód. Doporučujeme vám, abyste přispět způsobem, který nejlépe odpovídá vaší schopnosti, psát návody, dávat demo na místních setkáních, pomáhá ostatním uživatelům s jejich podporu, otázky, nebo revize dokumentace.

Přečtěte si naše přispívající pokyny v příručce pro důkladný úvod do toho, jak se můžete zapojit. Dodržování těchto pokynů pomáhá sdělit, že respektujete čas ostatních přispěvatelů na projektu. Na oplátku, udělají vše pro to, aby při práci s vámi tento respekt oplatili, napříč časovými pásmy a po celém světě.

vedení

WP-CLI má jednoho správce projektu: schlessera.

příležitostně poskytujeme přístup k zápisu přispěvatelům, kteří po určitou dobu prokázali, že jsou schopni a investovali do posunu projektu vpřed.

Přečtěte si dokument řízení v příručce pro více provozních podrobností o projektu.

Kredity

kromě knihoven definovaných v Composeru.json, jsme použili kód, nebo nápady z následujících projektů:

  • Drush… hodně věcí
  • wpshell pro wp shell
  • Regenerovat Miniatury pro wp media regenerate
  • Hledat-Nahradit-DB wp search-replace
  • WordPress-CLI-Vývozce pro wp export
  • WordPress-CLI-Dovozce pro wp import
  • wordpress-plugin-testy pro wp scaffold plugin-tests