WP-CLI to narzędzie do zarządzania WordPress z linii poleceń: To, co w panelu zajmuje wiele kliknięć, tutaj wykonujesz jednym poleceniem. Jest szybkie przy powtarzalnych zadaniach i nieocenione, gdy stracisz dostęp do panelu, a działa przez SSH, więc korzystasz z niego na pakiecie Cloud PRO. Ten poradnik pokazuje polecenia, które przydają się najczęściej.
Czego potrzebujesz
- Dostęp SSH, dostępny w pakiecie Cloud PRO. Jak się połączyć, opisujemy w poradniku o SSH i FTP, a różnice pakietów w artykule o Cloud Mini i Cloud PRO.
- Po zalogowaniu przez SSH przejdź do katalogu z plikami WordPress (tam, gdzie leży
wp-config.php). WP-CLI rozpoznaje instalację po tym katalogu, więc polecenia wydajesz z jego wnętrza.
Wskazówka
Większość poleceń ma tryb podglądu lub szczegółowy opis. Dopisz --help do dowolnej komendy (np. wp plugin --help), żeby zobaczyć dostępne opcje bez ryzyka, że coś zmienisz.
Sprawdź, czy wszystko działa
Zacznij od poleceń, które niczego nie zmieniają, tylko pokazują stan instalacji:
wp --info
wp core version
wp option get siteurl
Pierwsze pokazuje informacje o środowisku, drugie wersję WordPress, trzecie adres strony zapisany w bazie. To dobry sposób, by upewnić się, że jesteś w katalogu właściwej witryny.
Aktualizuj wtyczki i motywy hurtem
Tu WP-CLI oszczędza najwięcej czasu. Zamiast klikać każdą aktualizację osobno, robisz to jednym poleceniem:
wp plugin update --all
wp theme update --all
wp core update
wp core update-db
Kolejno: Aktualizacja wszystkich wtyczek, wszystkich motywów, rdzenia WordPress i struktury bazy po aktualizacji rdzenia. Regularne aktualizacje to podstawa bezpieczeństwa, co opisujemy w artykule o bezpieczeństwie WordPress.
Uwaga
Przed hurtową aktualizacją wykonaj kopię zapasową (patrz niżej). Jeśli któraś aktualizacja coś popsuje, wrócisz do działającej wersji. Większe zmiany najlepiej najpierw sprawdzić na środowisku testowym.
Zarządzaj wtyczkami i motywami
WP-CLI pozwala szybko przejrzeć i uporządkować dodatki:
wp plugin list
wp plugin deactivate nazwa-wtyczki
wp plugin activate nazwa-wtyczki
wp plugin delete nazwa-wtyczki
wp plugin list pokazuje wszystkie wtyczki wraz ze statusem i dostępnymi aktualizacjami. To wygodne przy diagnozie: Gdy strona działa źle, możesz dezaktywować wtyczki po kolei i sprawdzać, która jest przyczyną, bez wchodzenia do panelu.
Podmień adresy w bazie: Search-replace
To najczęściej doceniana funkcja WP-CLI. Adresy stron WordPress zapisuje w wielu miejscach bazy, w tym wewnątrz danych, których nie wolno edytować zwykłym “znajdź i zamień”. Polecenie wp search-replace robi to bezpiecznie:
wp search-replace 'https://stary-adres.pl' 'https://nowy-adres.pl' --dry-run
Opcja --dry-run to podgląd: Pokazuje, ile zmian zostałoby wykonanych, ale niczego nie zapisuje. Gdy wynik wygląda poprawnie, powtórz polecenie bez --dry-run, żeby zastosować zmiany.
Przydaje się przy zmianie adresu WordPress i przy tworzeniu kopii roboczej (staging), gdy kopia musi działać pod innym adresem.
Uwaga
Przed wp search-replace zawsze zrób kopię bazy. To operacja na wielu tabelach naraz i trudno ją cofnąć ręcznie.
Odzyskaj dostęp i zarządzaj kontami
WP-CLI ratuje sytuację, gdy nie możesz zalogować się do panelu (np. zapomniane hasło administratora):
wp user list
wp user reset-password nazwa-uzytkownika
wp user create nowy [email protected] --role=administrator
Kolejno: Lista kont, ustawienie nowego hasła dla wskazanego użytkownika oraz utworzenie nowego administratora. Pierwsze polecenie pomaga też wychwycić nieznane konta, co bywa sygnałem włamania.
Posprzątaj i odśwież stronę
Kilka poleceń przydatnych przy diagnostyce i porządkach:
wp cache flush
wp transient delete --all
wp rewrite flush
wp cron event list
wp cron event run --due-now
Czyszczą pamięć podręczną i dane tymczasowe, odświeżają strukturę odnośników oraz pozwalają sprawdzić i uruchomić zaplanowane zadania. To ostatnie łączy się z konfiguracją crona i WP-Cron. Po większych zmianach w mediach przydaje się też wp media regenerate, które przelicza miniatury obrazów.
Wykonaj kopię przed większymi zmianami
Każdą poważniejszą operację (hurtowa aktualizacja, search-replace, czyszczenie) poprzedź kopią zapasową.
- Kopię bazy danych wykonasz w phpMyAdmin (eksport do pliku), co opisujemy przy konserwacji bazy MySQL.
- Hosting webh dodatkowo wykonuje kopie co godzinę i przechowuje je przez 21 dni, a przywracasz je samodzielnie zgodnie z poradnikiem o kopiach. To dodatkowy bezpiecznik niezależny od WP-CLI.
Najczęstsze pytania
Czy WP-CLI działa na każdym pakiecie hostingu?
WP-CLI wymaga dostępu SSH, dostępnego w pakiecie Cloud PRO. Na Cloud Mini, bez SSH, WordPress zarządzasz z panelu administracyjnego strony.
Czy mogę zepsuć stronę poleceniami WP-CLI?
WP-CLI jest potężne, a część poleceń zmienia bazę lub pliki. Dlatego korzystaj z trybu --dry-run tam, gdzie jest dostępny, a przed większymi operacjami wykonuj kopię zapasową. Wtedy każdą zmianę da się wycofać.
Jak najlepiej zrobić pełną kopię bazy?
Do eksportu i importu bazy używaj phpMyAdmin, jak opisujemy przy konserwacji bazy MySQL. Dodatkowo masz automatyczne kopie hostingu co godzinę, opisane w poradniku o kopiach.
Zapomniałem hasła administratora, czy WP-CLI pomoże?
Tak. Wyświetl konta poleceniem wp user list, a następnie ustaw nowe hasło przez wp user reset-password nazwa-uzytkownika. Nie potrzebujesz do tego dostępu do panelu WordPress.