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.

Stan kompilacji średni czas rozwiązania problemu procent spraw wciąż otwartych

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