WP-CLI to interfejs linii poleceń dla WordPress. Pozwala instalować pluginy, zarządzać użytkownikami, wykonywać operacje na bazie danych i więcej – wszystko z terminala, bez dotykania panelu administratora WordPress. Ten przewodnik obejmuje instalację na Linux, macOS i Windows oraz kroki weryfikacji i rozwiązywania najczęstszych problemów.
TL;DR: Na Linux lub macOS (metoda phar) pobierz plik Phar, ustaw go jako wykonywalny i przenieś do swojego PATH. Na macOS najszybsza droga to
brew install wp-cli. Na Windows zainstaluj Cygwin lub użyj WSL2, a następnie postępuj zgodnie z krokami dla Linux. Uruchomwp --version, by potwierdzić, że instalacja zadziałała.
Szybkie zestawienie platform i metod
| Platforma | Zalecana metoda | Alternatywa |
|---|---|---|
| Linux | curl (phar) | Composer |
| macOS | Homebrew (brew install wp-cli) |
curl (phar) |
| Windows (Cygwin) | curl (phar) w terminalu Cygwin | — |
| Windows (WSL2) | Postępuj zgodnie z krokami dla Linux w WSL2 | — |
WP-CLI można też zainstalować jako pakiet Composer; zobacz oficjalną dokumentację WP-CLI dla instrukcji require wp-cli/wp-cli.
Wymagania
- PHP 5.4 lub nowszy
- WordPress 3.7 lub nowszy
- Dostęp SSH do serwera dla instalacji na Linux
- Uprawnienia administratora dla instalacji na Windows
Instalacja na Linux
- Pobierz WP-CLI:
Otwórz okno terminala i pobierz plik Phar WP-CLI za pomocą curl:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.pharW naszych testach na Ubuntu 22.04 LTS metoda curl kończy się w mniej niż minutę na standardowym połączeniu serwerowym.
- Ustaw WP-CLI jako wykonywalny:
Ustaw pobrany plik Phar jako wykonywalny:
chmod +x wp-cli.phar- Przenieś WP-CLI do katalogu Bin:
Przenieś plik wykonywalny do katalogu w twoim PATH. Katalog /usr/local/bin jest standardową lokalizacją:
sudo mv wp-cli.phar /usr/local/bin/wp- Zweryfikuj instalację WP-CLI:
Sprawdź, czy WP-CLI jest poprawnie zainstalowane, wyświetlając jego informacje systemowe:
wp --infoInstalacja na macOS
macOS to główne środowisko deweloperskie wielu deweloperów WordPress. Metoda Homebrew jest najprostszą drogą i automatycznie utrzymuje WP-CLI w aktualnej wersji.
Instalacja przez Homebrew (zalecane)
Jeśli masz zainstalowany Homebrew, uruchom:
brew install wp-cliPo instalacji potwierdź, że działa:
wp --versionInstalacja przez Phar (bez Homebrew)
Jeśli wolisz metodę ręczną, kroki Phar dla Linux działają na macOS bez modyfikacji:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
wp --versionInstalacja na Windows
- Download WP-CLI:
Odwiedź stronę WP-CLI na GitHub i pobierz najnowszy plik Phar z:
https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar- Pobierz i zainstaluj Cygwin:
WP-CLI wymaga terminala uniksowego. Pobierz i zainstaluj Cygwin z oficjalnej strony:
https://www.cygwin.com/Podczas instalacji upewnij się, że instalujesz pakiety curl, php, php-curl, php-mbstring, openssl i openssh.
- Przenieś WP-CLI do katalogu Cygwin:
Przenieś plik wp-cli.phar do katalogu domowego Cygwin, zwykle C:cygwin64homeYour_User.
- Make WP-CLI Executable:
Otwórz terminal Cygwin i przejdź do katalogu domowego poleceniem cd ~. Następnie ustaw plik Phar jako wykonywalny:
chmod +x wp-cli.phar- Move WP-CLI to Bin Directory:
Przenieś plik wykonywalny do PATH. Katalog /usr/bin w Cygwin jest standardową lokalizacją:
mv wp-cli.phar /usr/bin/wp- Verify WP-CLI Installation:
Check that WP-CLI is installed correctly by displaying its system information:
wp --infoZweryfikuj instalację
Po zainstalowaniu WP-CLI dowolną metodą potwierdź, że działa, dwoma poleceniami.
Sprawdź wersję:
wp --versionPolecenie wypisuje ciąg wersji typu WP-CLI x.y.z. Sprawdź stronę wydań WP-CLI, by potwierdzić, że masz najnowszą wersję.
Uruchom podstawowy health check:
wp doctor checkTo sprawdza typowe problemy konfiguracyjne. Uruchom z poziomu katalogu WordPress, aby uzyskać wyniki specyficzne dla witryny. Polecenie doctor jest częścią pakietu wp-cli/doctor-command, który wymaga osobnej instalacji – zobacz README wp-cli/doctor-command dla instrukcji konfiguracji.
Rozwiązywanie problemów
Z naszych zgłoszeń wsparcia WP STAGING wynika, że najczęstszą przyczyną niepowodzeń instalacji WP-CLI jest źle skonfigurowane PATH. Poniżej najczęstsze tryby awarii i ich naprawy.
wp: command not found po instalacji (Linux/macOS)
Phar WP-CLI nie został umieszczony w katalogu znajdującym się w twoim $PATH. Potwierdź, gdzie zostało przeniesione wp:
which wpJeśli polecenie nic nie zwraca, binarka nie znajduje się w twoim PATH. Dodaj /usr/local/bin do PATH, edytując ~/.bashrc lub ~/.zshrc:
export PATH="$PATH:/usr/local/bin"
source ~/.bashrcNastępnie ponów wp --version.
PHP nie znalezione w PATH (Windows / Cygwin)
WP-CLI wymaga PHP dostępnego z terminala. W Cygwin zweryfikuj, że PHP jest zainstalowane, uruchamiając php --version. Jeśli zwraca błąd, uruchom ponownie instalator Cygwin i dodaj pakiet php.
Permission denied dla pliku Phar (Linux/macOS)
Jeśli widzisz błąd „Permission denied” przy przenoszeniu pliku do /usr/local/bin, poprzedź polecenie sudo:
sudo mv wp-cli.phar /usr/local/bin/wpJeśli sudo jest niedostępne (np. na hostingu współdzielonym), przenieś plik do katalogu zapisywalnego przez użytkownika (np. ~/bin/) i dodaj ten katalog do PATH zamiast tego.
Niezgodność wersji PHP
WP-CLI wymaga PHP 5.4 lub nowszego. Uruchom php --version, by sprawdzić wersję, do której rozwiązuje się twój terminal. Jeśli masz zainstalowanych wiele wersji PHP, wersja, którą wybiera WP-CLI, jest determinowana kolejnością w PATH. W większości przypadków problem ten widzimy na serwerach z wersją PHP poniżej minimum 5.4 – aktualizacja PHP do spełnienia wymagań rozwiązuje go. Zobacz php.net/manual/en/install.php dla wskazówek instalacji PHP.
Podsumowanie
Teraz, gdy WP-CLI jest zainstalowane, możesz zacząć go używać do zarządzania witryną WordPress z linii poleceń. Oficjalna dokumentacja WP-CLI obejmuje pełne referencje poleceń i podręcznik.
