12 min. czytać

WP-CLI: Kompletny przewodnik po zarządzaniu WordPressem z poziomu wiersza poleceń

WP-CLI to oficjalne narzędzie wiersza poleceń do zarządzania instalacjami WordPress bezpośrednio z terminala, bez konieczności otwierania przeglądarki. Jeśli kiedykolwiek spędziłeś popołudnie, klikając w panelu administracyjnym WordPress, aby zaktualizować wtyczki w wielu witrynach, wiesz już, dlaczego to narzędzie istnieje.

W tym przewodniku dowiesz się wszystkiego, od instalacji WP-CLI w systemach Linux, macOS i Windows po automatyzację złożonych zadań konserwacyjnych za pomocą skryptów i plików konfiguracyjnych. Niezależnie od tego, czy zarządzasz pojedynczym blogiem, czy dziesiątkami witryn klientów, opanowanie WP-CLI zasadniczo zmieni sposób pracy z WordPressem.

Czego się nauczysz:

Jak zainstalować i skonfigurować WP-CLI w różnych systemach operacyjnych?
Niezbędne polecenia do zarządzania wtyczkami, motywami, użytkownikami i zawartością
Operacje na bazie danych, w tym eksport, import i bezpieczne wyszukiwanie-zamiana
Techniki automatyzacji wykorzystujące skrypty, aliasy i zadania cron
Najlepsze praktyki pozwalające uniknąć typowych pułapek podczas pracy z terminala

Czym jest WP-CLI? (Najpierw krótkie wyjaśnienie)

WP-CLI to skrót od WordPress Command Line Interface – narzędzia o otwartym kodzie źródłowym, które pozwala zarządzać witrynami WordPress całkowicie z terminala. Zamiast logować się do wp-admin i nawigować po menu, uruchamiasz polecenia takie jak wp plugin update --all i obserwujesz, jak cały stos wtyczek aktualizuje się w ciągu kilku sekund.

Projekt rozpoczął się około 2011 roku, stworzony przez programistów, którzy chcieli szybszego sposobu zarządzania WordPressem na dużą skalę. W 2017 roku przeszedł pod oficjalny parasol WordPress.org i jest obecnie utrzymywany przez dedykowany zespół współpracowników, w tym Alaina Schlessera i Daniela Bachhubera.

Oto, co musisz wiedzieć o WP-CLI:

Aktualna stabilna wersja: WP-CLI 2.x series
Kompatybilność z WordPress: Działa z WordPress 5.x do 6.x (i historycznie do 3.7).
Wymagania PHP: PHP 7.4+ lub 8.x zalecane dla bezpieczeństwa i wydajności
Ekosystem poleceń: Ponad 40 poleceń nadrzędnych obejmujących praktycznie każdą operację WordPressa
Główni użytkownicy: Programiści, agencje, inżynierowie DevOps i zaawansowani użytkownicy zarządzający złożonymi lub wieloma witrynami.
Dystrybucja: Dostępny jako plik PHAR, za pośrednictwem menedżerów pakietów lub wstępnie zainstalowany na wielu zarządzanych hostach WordPress.

Główne zalety korzystania z WP-CLI

Po zrozumieniu, dlaczego WP-CLI istnieje, krzywa uczenia się staje się znacznie łatwiejsza do uzasadnienia. Ta sekcja wyjaśnia konkretne zalety, które sprawiają, że to narzędzie jest warte twojego czasu.

Oszczędność czasu na powtarzalnych zadaniach
Aktualizacja 20 wtyczek za pośrednictwem pulpitu WordPress oznacza 20 załadowań strony, 20 kliknięć i obserwowanie 20 pasków postępu. Z WP-CLI, uruchamiasz wp plugin update --all raz i idziesz dalej. W przypadku agencji zarządzających wieloma witrynami klientów różnica ta przekłada się na godziny zaoszczędzone każdego tygodnia.

Operacje masowe i zautomatyzowane
Rozważmy scenariusz, w którym przygotowujesz 15 sklepów WooCommerce na Black Friday. Musisz zaktualizować wtyczki, wyczyścić pamięć podręczną i zweryfikować integralność bazy danych w każdej witrynie. WP-CLI pozwala skryptować całą tę sekwencję i wykonywać ją we wszystkich witrynach w ciągu kilku minut, a nie godzin. Kluczowe możliwości automatyzacji obejmują:

Aktualizacja wszystkich wtyczek w wielu instalacjach za pomocą jednego skryptu
Zbiorcze tworzenie użytkowników z predefiniowanymi rolami
Uruchamianie nocnej konserwacji za pośrednictwem crona (optymalizacja bazy danych, czyszczenie przejściowe)
Wdrażanie identycznych konfiguracji WordPress w nowych środowiskach

Niezawodność w operacjach opartych na przeglądarce
Operacje w przeglądarce powodują przekroczenie limitu czasu HTTP. Importowanie dużych baz danych kończy się niepowodzeniem w połowie procesu. Operacje zastępowania wyszukiwania uszkadzają serializowane dane, gdy są wykonywane przy użyciu nieprzetworzonego kodu SQL. WP-CLI unika wszystkich tych problemów, ponieważ działa bezpośrednio na serwerze bez ograniczeń czasowych, a jego polecenie search-replace poprawnie obsługuje serializowane struktury danych.

Bezpośrednia kontrola nad podstawowymi systemami WordPress
Z jednego terminala możesz:

Eksport i import bazy danych WordPress
Modyfikacja ustawień wp-config.php
Sprawdzanie i wyzwalanie zdarzeń wp-cron
Włączanie i wyłączanie trybu konserwacji
Uruchamianie dowolnego kodu PHP w kontekście WordPress

Zmniejszone obciążenie wp-admin
Na obciążonych serwerach produkcyjnych każde załadowanie strony panelu administracyjnego zużywa zasoby. Uruchamianie operacji konserwacyjnych za pośrednictwem WP-CLI zmniejsza obciążenie serwera WWW, co ma znaczenie w okresach dużego ruchu.

Wymagania WP-CLI i obsługiwane środowiska

Przed instalacją WP-CLI należy potwierdzić, że serwer lub środowisko lokalne spełnia podstawowe wymagania. Dobrą wiadomością jest to, że większość nowoczesnych konfiguracji WordPress już się do tego kwalifikuje.

Wymagania dotyczące wersji PHP:

Minimum: PHP 5.6 (choć jest to przestarzałe)
Zalecane: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 lub 8.5 dla bezpieczeństwa i wydajności w 2026 r.

Zgodność z wersją WordPress:

Wsparcie historyczne: WordPress 3.7 i nowsze
Nowoczesny cel: WordPress 5.0 do 6.7+ dla bieżących projektów

Oczekiwania dotyczące systemu operacyjnego:

Najlepsze wsparcie: Systemy typu UNIX (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS)
Windows: Obsługiwane przez WSL (Windows Subsystem for Linux) lub natywną instalację PHP.

Dodatkowe wymagania:

PHP dostępne w wierszu poleceń (plik binarny php musi znajdować się w PATH)
cURL lub wget do pobrania pliku wp-cli.phar
Dostęp SSH do zdalnych serwerów (większość zarządzanych planów hostingowych WordPress zawiera to domyślnie)

Wiele popularnych hostów, takich jak Kinsta, SiteGround i DreamHost, jest teraz dostarczanych z preinstalowanym WP-CLI. WordPress.com zawiera również WP-CLI dla witryn z włączonym dostępem SSH.

Jak zainstalować WP-CLI w systemach Linux i macOS

Standardowa metoda instalacji wykorzystuje oficjalny plik PHAR (PHP Archive). Proces ten działa na terminalach Ubuntu, Debian, CentOS, Fedora i macOS.

Krok 1: Pobierz plik PHAR
Otwórz terminal i pobierz wp-cli.phar za pomocą curl:

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

Alternatywą jest użycie wget:

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

Krok 2: Zweryfikuj pobrany plik (opcjonalne, ale zalecane)
Sprawdź sumę kontrolną SHA-256 w stosunku do oficjalnej wartości opublikowanej w dokumentacji WP-CLI, aby upewnić się, że plik nie został zmodyfikowany podczas pobierania:

sha256sum wp-cli.phar

Porównaj dane wyjściowe z sumą kontrolną podaną na oficjalnej stronie WP-CLI.

Krok 3: Przetestuj plik PHAR
Sprawdź, czy plik php działa:

php wp-cli.phar --info

Powinieneś zobaczyć dane wyjściowe wyświetlające wersję WP-CLI, wersję PHP i informacje o systemie.

Krok 4: Uczyń go wykonywalnym i przenieś do PATH
Oznacz plik jako wykonywalny i przenieś go do katalogu w systemowej PATH:

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

Polecenie sudo jest zazwyczaj wymagane, ponieważ /usr/local/bin jest katalogiem systemowym. Unikaj instalowania WP-CLI jako root, jeśli będziesz go uruchamiać głównie jako zwykły użytkownik.

Krok 5: Zweryfikuj globalną instalację
Potwierdź, że WP-CLI jest teraz dostępne globalnie:

wp --info
wp cli version

Powinieneś zobaczyć dane wyjściowe potwierdzające wersję wp cli, lokalizację binarną PHP i szczegóły systemu operacyjnego. W tym momencie WP-CLI jest zainstalowane i gotowe do użycia.

Jak zainstalować WP-CLI w systemie Windows

Użytkownicy systemu Windows mają dwie główne ścieżki: korzystanie z Windows Subsystem for Linux (WSL) lub skonfigurowanie natywnej instalacji systemu Windows. WSL zapewnia bardziej zbliżone do Linuksa doświadczenie i jest ogólnie zalecane.

Opcja 1: Korzystanie z WSL (zalecane)
Najpierw włącz WSL w systemie Windows 10 lub 11:

wsl --install

Zainstaluj Ubuntu ze sklepu Microsoft Store, a następnie uruchom terminal Ubuntu. Stamtąd wykonaj dokładnie te same kroki instalacji Linuksa, które opisano w poprzedniej sekcji – pobierz plik phar, uczyń go wykonywalnym i przenieś na stronę /usr/local/bin/wp.

Opcja 2: natywna instalacja w systemie Windows
W przypadku natywnej instalacji, wymagane jest zainstalowanie PHP dla Windows z plikiem wykonywalnym php dostępnym w systemowej PATH.

Pobierz i zainstaluj PHP z oficjalnej strony PHP for Windows
Dodaj katalog PHP do zmiennej środowiskowej PATH systemu Windows
Potwierdź, że PHP działa, otwierając Command Prompt i uruchamiając php -v

Następnie pobierz plik WP-CLI PHAR:

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

Windows domyślnie zawiera curl od 2018 roku, więc powinno to działać bez dodatkowej konfiguracji. Utwórz folder dla WP-CLI (np. C:\wp-cli) i przenieś tam pobrany plik.

Następnie utwórz plik opakowujący o nazwie wp.bat w tym samym folderze:

@echo off
php "C:\wp-cli\wp-cli.phar" %*

Dodaj C:\wp-cli do systemowej zmiennej środowiskowej PATH. Teraz otwórz nowe okno Command Prompt lub PowerShell i zweryfikuj:

wp --info

Powinieneś zobaczyć wersję WP-CLI i szczegóły środowiska potwierdzające, że WP-CLI jest poprawnie zainstalowane.

Podstawowe korzystanie z WP-CLI i uzyskiwanie pomocy

Po zainstalowaniu WP-CLI należy zrozumieć podstawowy wzorzec poleceń przed zagłębieniem się w konkretne operacje. Wszystkie polecenia WP-CLI mają następującą strukturę:

wp <command> <subcommand> [options]

Polecenia są wykonywane z katalogu instalacyjnego WordPress – folderu zawierającego wp-config.php. Jeśli jesteś w innym miejscu, możesz określić ścieżkę za pomocą --path=/var/www/html/mysite.

Sprawdzanie środowiska
Zacznij od potwierdzenia konfiguracji:

wp --info

Wyświetla wersję WP-CLI, wersję PHP, ścieżkę binarną PHP, system operacyjny i inne szczegóły środowiska. Aby zobaczyć tylko wersję WP-CLI:

wp cli version

Przeglądanie dostępnych poleceń
Aby wyświetlić listę wszystkich dostępnych poleceń wp cli:

wp help

Aby uzyskać pomoc dotyczącą określonego polecenia:

wp help plugin
wp help core update

Do każdego polecenia można również dołączyć adres --help:

wp user --help

Wyjście pomocy jest wyświetlane w pagerze podobnym do uniksowych stron podręcznika. Naciśnij q aby wyjść.

Pierwsze polecenia do wypróbowania:

wp core version – wyświetla wersję WordPressa
wp plugin list – pokazuje wszystkie zainstalowane wtyczki WordPress wraz z ich statusem
wp theme list – pokazuje zainstalowane motywy
wp user list – wyświetla listę wszystkich użytkowników w witrynie

Te polecenia tylko do odczytu pozwalają eksplorować witrynę WordPress bez zmiany czegokolwiek, co jest idealne do wygodnego korzystania z interfejsu.

Instalacja i konfiguracja WordPress za pomocą WP-CLI

WP-CLI może wykonać kompletną, świeżą instalację WordPressa szybciej niż tradycyjny instalator internetowy. Jest to szczególnie cenne podczas tworzenia środowisk programistycznych lub programowego wdrażania nowych witryn.

Wymagania wstępne
Przed uruchomieniem poleceń instalacyjnych należy przygotować bazę danych MySQL lub MariaDB. Dla tego przykładu, załóżmy, że utworzyłeś:

Nazwa bazy danych: wpsite_db
Użytkownik bazy danych: wpsite_user
Hasło: securepassword123
Gospodarz: localhost

Krok 1: Pobierz pliki rdzenia WordPress
Przejdź do wybranego katalogu instalacyjnego i pobierz rdzeń WordPress:

wp core download

Powoduje to pobranie najnowszej wersji WordPress. Aby określić wersję lub ustawienia regionalne:

wp core download --version=6.4.2 --locale=fr_FR

Po zakończeniu zobaczysz potwierdzenie, że WordPress został pomyślnie pobrany.

Krok 2: Wygeneruj wp-config.php
Utwórz plik konfiguracyjny za pomocą wp config create:

wp config create --dbname=wpsite_db --dbuser=wpsite_user --dbpass=securepassword123 --dbhost=localhost

Spowoduje to wygenerowanie pełnego adresu wp-config.php z poświadczeniami bazy danych i automatycznie wygenerowanymi solami bezpieczeństwa.

Krok 3: Uruchom instalację
Teraz zainstaluj WordPress ze szczegółami swojej witryny:

wp core install --url=https://example.com --title="My New Site" --admin_user=admin --admin_password=strongpassword [email protected]

Zobaczysz komunikat „WordPress zainstalowany pomyślnie” i Twoja witryna będzie gotowa do użycia.

Instalacja wielostanowiskowa
W przypadku sieci wielostanowiskowych WordPress należy użyć wariantu wielostanowiskowego. WP-CLI może konfigurować instalacje wielostanowiskowe za pomocą:

wp core multisite-install --url=https://example.com --title="My Network" --admin_user=admin --admin_password=strongpassword [email protected]

Zarządzanie motywami za pomocą WP-CLI

WP-CLI obsługuje wszystkie operacje związane z motywami bez konieczności uzyskiwania dostępu do panelu administracyjnego WordPress. Możesz wyświetlać, instalować, aktywować, aktualizować i usuwać motywy bezpośrednio z terminala.

Lista zainstalowanych motywów
Aby wyświetlić wszystkie aktualnie zainstalowane motywy:

wp theme list

Przykładowe dane wyjściowe:

nazwa	status	aktualizacja	wersja
dwadzieścia dwadzieścia cztery	aktywny	none	1.0
dwadzieścia dwadzieścia trzy	nieaktywny	none	1.2
astra	nieaktywny	dostępny	4.5.0

Aktywacja motywu
Przejście do innego motywu:

wp theme activate astra

Spowoduje to natychmiastową zmianę aktywnego motywu. Powrót do domyślnego motywu jest przydatny podczas rozwiązywania problemów związanych z motywami:

wp theme activate twentytwentyfour

Instalowanie nowych motywów
Zainstaluj motyw z repozytorium WordPress.org:

wp theme install astra

Instalacja i aktywacja za pomocą jednego polecenia:

wp theme install astra --activate

Aktualizacja motywów
Aktualizacja określonego motywu:

wp theme update astra

Lub zaktualizować wszystkie motywy jednocześnie:

wp theme update --all

Usuwanie motywów
Usuń motyw, którego już nie potrzebujesz:

wp theme delete twentytwentythree

Zarządzanie wtyczkami za pomocą WP-CLI

Zarządzanie wtyczkami to obszar, w którym WP-CLI oszczędza najwięcej czasu. Możesz wykonywać masowe operacje, które wymagałyby dziesiątek kliknięć na pulpicie nawigacyjnym.

Listowanie wtyczek

wp plugin list

Przykładowe dane wyjściowe:

nazwa	status	aktualizacja	wersja
woocommerce	aktywny	none	8.5.1
yoast-seo	aktywny	dostępny	21.0
elementor	nieaktywny	none	3.18.0

Instalowanie wtyczek
Zainstaluj wtyczkę według jej slug:

wp plugin install woocommerce

Zainstaluj i aktywuj:

wp plugin install yoast-seo --activate

Aktywacja i dezaktywacja
Aktywacja wtyczki:

wp plugin activate elementor

Dezaktywacja wtyczki (przydatne do debugowania):

wp plugin deactivate elementor

Dezaktywacja wszystkich wtyczek jednocześnie (ratuje życie podczas debugowania „White Screen of Death”):

wp plugin deactivate --all

Aktualizacja wtyczek
Aktualizacja określonej wtyczki:

wp plugin update yoast-seo

Zaktualizuj wszystkie wtyczki:

wp plugin update --all

Można również wykluczyć określone wtyczki z aktualizacji zbiorczej:

wp plugin update --all --exclude=woocommerce

Aktualizacja i naprawa WordPress Core

Aktualizowanie WordPressa ma kluczowe znaczenie dla bezpieczeństwa. WP-CLI sprawia, że proces ten jest przejrzysty i możliwy do kontrolowania.

Sprawdzanie dostępności aktualizacji

wp core check-update

Aktualizacja WordPress
Aktualizacja do najnowszej wersji:

wp core update

Po aktualizacji rdzenia dobrą praktyką jest aktualizacja schematu bazy danych:

wp core update-db

Weryfikacja sum kontrolnych
Jeśli podejrzewasz, że Twoja witryna została zhakowana, możesz sprawdzić, czy podstawowe pliki nie zostały zmodyfikowane:

wp core verify-checksums

Porównuje to pliki z oficjalnymi sumami kontrolnymi repozytorium WordPress.

Ponowna instalacja Core
Jeśli pliki są uszkodzone, można wymusić ponowną instalację bez wpływu na zawartość:

wp core download --force --skip-content

Zarządzanie zawartością, użytkownikami i bazą danych

WP-CLI umożliwia bezpośrednią interakcję z danymi witryny.

Zarządzanie użytkownikami
Lista użytkowników:

wp user list

Utwórz nowego administratora:

wp user create newadmin [email protected] --role=administrator --user_pass=securepass123

Aktualizacja hasła użytkownika:

wp user update 1 --user_pass=newpassword

Usunięcie użytkownika i ponowne przypisanie jego zawartości:

wp user delete 5 --reassign=1

Operacje na bazie danych
Eksport bazy danych do pliku:

wp db export backup.sql

Import bazy danych z pliku:

wp db import backup.sql

Optymalizacja bazy danych:

wp db optimize

Otwórz konsolę MySQL bezpośrednio połączoną z bazą danych WordPress:

wp db cli

Wyszukiwanie i zastępowanie (właściwy sposób)

Ręczne przenoszenie witryny WordPress do nowej domeny jest ryzykowne, ponieważ dane są często serializowane w bazie danych. Proste wyszukiwanie i zamiana SQL spowoduje uszkodzenie widżetów i opcji motywu. WP-CLI poprawnie obsługuje serializację.

Standardowe wyszukiwanie-zastępowanie

wp search-replace 'http://old-domain.com' 'https://new-domain.com'

Suchy przebieg (podgląd)
Zawsze sprawdzaj, co się zmieni przed uruchomieniem polecenia:

wp search-replace 'http://old-domain.com' 'https://new-domain.com' --dry-run

Eksportowanie z zastąpieniem
Można wyeksportować bazę danych z zastąpieniami dokonanymi w pliku, pozostawiając aktywną bazę danych nietkniętą:

wp search-replace 'old.com' 'new.com' --export=migrated-db.sql

Zaawansowana konserwacja: Cron i Object Cache

Zarządzanie zadaniami Cron
Wyświetlanie zaplanowanych zdarzeń:

wp cron event list

Natychmiastowe uruchamianie wszystkich zdarzeń cron:

wp cron event run --due-now

Zarządzanie stanami nieustalonymi i pamięcią podręczną
Wyczyść pamięć podręczną obiektów:

wp cache flush

Usuń wszystkie wygasłe stany nieustalone:

wp transient delete --expired

Automatyzacja zadań za pomocą skryptów

Polecenia WP-CLI można łączyć w skrypty Bash w celu zautomatyzowanej konserwacji.

Przykład: Weekly Maintenance Script
Utwórz plik o nazwie maintain.sh:

#!/bin/bash
# Update everything
wp core update
wp core update-db
wp plugin update --all
wp theme update --all

# Cleanup
wp transient delete --expired
wp cache flush
wp db optimize

echo "Maintenance complete."

Utwórz plik wykonywalny (chmod +x maintain.sh) i uruchom go, aby wykonać pełną konserwację witryny w ciągu kilku sekund.

Zdalne korzystanie z WP-CLI przez SSH

Po skonfigurowaniu aliasów nie trzeba logować się do serwera, aby uruchamiać polecenia.

W lokalnym pliku wp-cli.yml:

@prod:
  ssh: [email protected]/var/www/html
@dev:
  ssh: [email protected]/var/www/html

Teraz możesz uruchamiać polecenia na zdalnym serwerze z lokalnego komputera:

wp @prod plugin list
wp @dev core version

Najlepsze praktyki

Zawsze twórz kopie zapasowe: Przed uruchomieniem aktualizacji zbiorczych lub poleceń wyszukiwania i zamiany należy uruchomić stronę wp db export.
Użyj Dry Run: Aby zastąpić wyszukiwanie, zawsze najpierw używaj --dry-run.
Nie uruchamiaj jako root: WP-CLI ostrzega przed uruchomieniem jako root. Bezpieczniej jest uruchomić jako użytkownik serwera WWW (np. www-data) lub określone konto użytkownika.
Test na Staging: Użyj WP-CLI, aby sklonować witrynę produkcyjną do etapu przejściowego, przetestować tam skrypty aktualizacji, a następnie zastosować je w produkcji.

Wnioski

WP-CLI przekształca zarządzanie WordPressem z serii kliknięć w usprawnione, skryptowalne operacje. Począwszy od prostych poleceń, takich jak sprawdzanie wersji i listowanie wtyczek, buduje fundament dla zaawansowanej automatyzacji. Włączenie WP-CLI do swojego przepływu pracy już dziś pozwoli zaoszczędzić niezliczone godziny w projektach WordPress.