interfejs wiersza poleceń dla WordPress
WP-CLI to interfejs wiersza poleceń dla WordPress. Możesz aktualizować wtyczki, konfigurować instalacje wielostanowiskowe i wiele więcej, bez użycia przeglądarki internetowej.
bieżąca konserwacja jest możliwa dzięki:
aktualną wersją stabilną jest Wersja 2.4.0. Aby otrzymywać ogłoszenia, śledź @wpcli na Twitterze lub Zarejestruj się, aby otrzymywać aktualizacje e-mail. Zapoznaj się z harmonogramem, aby dowiedzieć się, co jest planowane w nadchodzących wydaniach.
Szybkie linki: używanie | instalacja | wsparcie | Rozszerzanie | Contributing | Credits
używanie
WP-CLI zapewnia interfejs wiersza poleceń dla wielu działań, które możesz wykonać może występować w panelu administracyjnym WordPress. Na przykład wp plugin install --activate
(doc) pozwala zainstalować i aktywować wtyczkę do WordPressa:
$ 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 zawiera również polecenia dla wielu rzeczy, których nie możesz zrobić w panelu administracyjnym WordPress. Na przykład wp transient delete --all
(doc) pozwala usunąć jeden lub wszystkie przejścia:
$ wp transient delete --allSuccess: 34 transients deleted from the database.
aby uzyskać pełniejsze wprowadzenie do korzystania z WP-CLI, przeczytaj krótki przewodnik. Możesz też spotkać się ze znajomymi z powłoki, aby dowiedzieć się więcej o przydatnych narzędziach wiersza poleceń.
już czujesz się komfortowo z podstawami? Przejdź do pełnej listy poleceń, aby uzyskać szczegółowe informacje na temat zarządzania motywami i wtyczkami, importowania i eksportowania danych, wykonywania operacji wyszukiwania w bazie danych i innych.
instalacja
Pobieranie pliku Phar jest naszą zalecaną metodą instalacji dla większości użytkowników. Jeśli potrzebujesz, zapoznaj się również z naszą dokumentacją na temat alternatywnych metod instalacji (Composer, Homebrew, Docker).
przed zainstalowaniem WP-CLI upewnij się, że Twoje środowisko spełnia minimalne wymagania:
- środowisko UNIKSOPODOBNE (OS X, Linux, FreeBSD, Cygwin); ograniczone wsparcie dla środowiska Windows
- PHP 5.6 lub nowszy
- WordPress 3.7 lub nowszy. Wersje starsze niż najnowsze wydanie WordPress mogą mieć zdegradowaną funkcjonalność
po zweryfikowaniu wymagań Pobierz wp-cli.plik phar za pomocą wget
lub curl
:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
następnie sprawdź plik Phar, aby sprawdzić, czy działa:
php wp-cli.phar --info
aby użyć WP-CLI z wiersza poleceń, wpisując wp
, Utwórz plik wykonywalny I przenieś go gdzieś w ścieżce. Na przykład:
chmod +x wp-cli.pharsudo mv wp-cli.phar /usr/local/bin/wp
jeśli WP-CLI został zainstalowany pomyślnie, powinieneś zobaczyć coś takiego podczas uruchamiania 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
aktualizacja
możesz zaktualizować WP-CLI za pomocą wp cli update
(doc) lub powtarzając kroki instalacji.
jeśli WP-CLI jest własnością roota lub innego użytkownika systemowego, musisz uruchomić sudo wp cli update
.
chcesz żyć na krawędzi? Uruchom wp cli update --nightly
, aby użyć najnowszej nightly build WP-CLI. Nightly build jest mniej więcej wystarczająco stabilny, aby można go było używać w środowisku programistycznym i zawsze zawiera najnowsze i najlepsze funkcje WP-CLI.
uzupełnienia kart
WP-CLI zawiera również skrypt uzupełniania kart dla Bash i ZSH. Wystarczy pobrać wp-completion.bash i źródło go z ~/.bash_profile
:
source /FULL/PATH/TO/wp-completion.bash
nie zapomnij uruchomić source ~/.bash_profile
później.
jeśli używasz zsh dla swojej powłoki, może być konieczne załadowanie i rozpoczęcie bashcompinit
przed pozyskaniem. Umieść w swoim .zshrc
:
autoload bashcompinitbashcompinitsource /FULL/PATH/TO/wp-completion.bash
wsparcie
opiekunowie i współpracownicy WP-CLI mają ograniczoną dostępność odpowiedzi na ogólne pytania dotyczące pomocy technicznej. Aktualna wersja WP-CLI jest jedyną oficjalnie obsługiwaną wersją.
szukając wsparcia, najpierw Wyszukaj swoje pytanie w tych miejscach:
- typowe problemy i ich poprawki
- podręcznik WP-CLI
- otwarte lub zamknięte problemy w organizacji WP-Cli GitHub
- Wątki oznaczone 'WP-CLI’ w WordPress.org forum wsparcia
- pytania oznaczone 'WP-CLI’ w WordPress StackExchange
jeśli nie znalazłeś odpowiedzi w jednym z powyższych miejsc, możesz:
- Dołącz do
#cli
kanału w WordPress.org Slack, aby porozmawiać z kimkolwiek, kto może być dostępny w tym czasie. Ta opcja jest najlepsza dla szybkich pytań. - Dodaj nowy wątek w WordPress.org wspieraj forum i oznacz je jako’ WP-CLI’, aby było widziane przez społeczność.
problemy z GitHub są przeznaczone do śledzenia ulepszeń i błędów istniejących poleceń, a nie ogólnego wsparcia. Przed wysłaniem raportu o błędzie zapoznaj się z naszymi najlepszymi praktykami, aby upewnić się, że problem został rozwiązany w odpowiednim czasie.
nie zadawaj pytań pomocy technicznej na Twitterze. Twitter nie jest akceptowalnym miejscem wsparcia, ponieważ: 1) trudno jest prowadzić rozmowy poniżej 280 znaków, a 2) Twitter nie jest miejscem, w którym ktoś z tym samym pytaniem może szukać odpowiedzi we wcześniejszej rozmowie.
pamiętaj, libre != gratis; Licencja open source daje Ci swobodę używania i modyfikowania, ale nie angażowania czasu innych ludzi. Prosimy o szacunek i odpowiednio ustawić swoje oczekiwania.
komenda jest jednostką atomową funkcjonalności WP-CLI. wp plugin install
(doc) jest jednym poleceniem. wp plugin activate
(doc) jest inny.
WP-CLI obsługuje rejestrowanie dowolnej klasy, funkcji lub zamknięcia jako polecenia. Odczytuje szczegóły użycia z PHPDoc wywołania zwrotnego. WP_CLI::add_command()
(doc) służy zarówno do rejestracji poleceń wewnętrznych, jak i zewnętrznych.
/** * 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 zawiera dziesiątki poleceń. Łatwiej niż się wydaje, aby utworzyć niestandardowe polecenie WP-CLI. Przeczytaj książkę kucharską poleceń, aby dowiedzieć się więcej. Przejrzyj wewnętrzne dokumenty API, aby odkryć wiele przydatnych funkcji, których możesz użyć w niestandardowym poleceniu WP-CLI.
przyczyniając się
dziękujemy, że podjąłeś inicjatywę, aby przyczynić się do WP-CLI. To dzięki Tobie i społeczności wokół ciebie WP-CLI jest tak świetnym projektem.
wkład nie ogranicza się tylko do kodu. Zachęcamy do wnoszenia wkładu w sposób, który najlepiej pasuje do Twoich umiejętności, pisząc samouczki, dając demo na lokalnym spotkaniu, pomagając innym użytkownikom w ich pytaniach dotyczących wsparcia lub poprawiając naszą dokumentację.
zapoznaj się z naszymi wskazówkami w podręczniku, aby dowiedzieć się, w jaki sposób możesz się zaangażować. Przestrzeganie tych wytycznych pomaga zakomunikować, że szanujesz czas innych współpracowników w projekcie. Z kolei dołożą wszelkich starań, aby odwzajemnić ten szacunek podczas pracy z Tobą, w różnych strefach czasowych i na całym świecie.
Kierownictwo
WP-CLI ma jednego opiekuna projektu: schlessera.
czasami udzielamy dostępu do zapisu współpracownikom, którzy przez pewien czas wykazali, że są w stanie i zainwestowali w rozwój projektu.
przeczytaj dokument dotyczący zarządzania w podręczniku, aby uzyskać więcej szczegółów operacyjnych na temat projektu.
oprócz bibliotek zdefiniowanych w composer.json, wykorzystaliśmy kod lub pomysły z następujących projektów:
- wiele rzeczy
- wpshell dla
wp shell
- regeneruj miniatury dla
wp media regenerate
- Szukaj-Zamień-DB dla
wp search-replace
- WordPress-Cli-Exporter dla
wp export
- WordPress-Cli-Importer dla
wp import
- WordPress-plugin-testy dla
wp scaffold plugin-tests