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