Jak korzystać z WP-CLI przez SSH?

Cel artykułu#

Dowiesz się, jak efektywnie zarządzać swoją stroną WordPress z poziomu linii komend za pomocą WP-CLI. Poznasz najczęściej używane komendy oraz zobaczysz, jak znacząco przyspieszyć typowe operacje administracyjne.

WP-CLI (WordPress Command Line Interface) to narzędzie wiersza poleceń, które pozwala zarządzać WordPress szybciej i efektywniej niż przez standardowy interfejs administracyjny. Jest nieocenione przy zadaniach takich jak masowe aktualizacje, zarządzanie wtyczkami, zarządzanie użytkownikami czy operacje na bazie danych.

Warunki wstępne#

Aby korzystać z WP-CLI na hostingu IQhost, potrzebujesz:

1. Pakietu hostingowego z dostępem SSH — WP-CLI jest dostępne w pakietach HS25 i wyższych
2. Skonfigurowanego dostępu SSH — więcej informacji znajdziesz w artykule o konfiguracji kluczy SSH
3. Programu do obsługi połączeń SSH na Twoim komputerze:
   • Windows: PuTTY lub Windows Terminal
   • macOS / Linux: Terminal (wbudowany)

Nawiązywanie połączenia SSH#

Aby połączyć się z serwerem przez SSH:

1. Otwórz terminal na swoim komputerze

2. Wprowadź polecenie:

   ssh hostXXXX@hostXXXX.iqhs.eu -p 2222
   

   (gdzie hostXXXX to Twoja nazwa użytkownika)

3. Wprowadź hasło lub użyj klucza SSH

Po połączeniu z serwerem zobaczysz komunikat powitalny i znak zachęty shella (najczęściej $).

Podstawowe komendy WP-CLI#

Po nawiązaniu połączenia SSH przejdź do katalogu z instalacją WordPress:

cd public_html

Lub jeśli WordPress jest zainstalowany w podkatalogu:

cd public_html/nazwa_katalogu

Teraz możesz zacząć korzystać z WP-CLI używając komendy wp. Najpierw sprawdź poprawność działania:

wp --info

To polecenie powinno wyświetlić informacje o środowisku WP-CLI, PHP i systemie.

Sprawdzanie wersji WordPress#

wp core version

Aktualizacja WordPress#

Aby zaktualizować rdzeń WordPress do najnowszej wersji:

wp core update

Następnie zaktualizuj bazę danych (jeśli jest to wymagane):

wp core update-db

Zarządzanie wtyczkami#

Wyświetlanie zainstalowanych wtyczek#

wp plugin list

Komenda wyświetli listę wszystkich zainstalowanych wtyczek wraz z ich statusem (aktywna/nieaktywna) i wersją.

Instalacja wtyczki#

wp plugin install nazwa-wtyczki

Na przykład, aby zainstalować Yoast SEO:

wp plugin install wordpress-seo

Aktywacja wtyczki#

wp plugin activate nazwa-wtyczki

Aktualizacja wtyczek#

Aktualizacja jednej wtyczki:

wp plugin update nazwa-wtyczki

Aktualizacja wszystkich wtyczek:

wp plugin update --all

Dezaktywacja i usuwanie wtyczek#

wp plugin deactivate nazwa-wtyczki
wp plugin delete nazwa-wtyczki

Zarządzanie motywami#

Komendy dla motywów są podobne do tych dla wtyczek:

# Lista zainstalowanych motywów
wp theme list

# Instalacja
wp theme install nazwa-motywu

# Aktywacja
wp theme activate nazwa-motywu

# Aktualizacja wszystkich
wp theme update --all

Zarządzanie użytkownikami#

Tworzenie nowego użytkownika#

wp user create username user@example.com --role=administrator

To polecenie utworzy nowego użytkownika i wygeneruje dla niego losowe hasło.

Zmiana hasła użytkownika#

wp user update ID --user_pass=nowe_haslo

Zastąp ID identyfikatorem użytkownika, który można sprawdzić komendą:

wp user list

Resetowanie hasła i wysłanie maila#

wp user reset-password username

Zarządzanie postami i stronami#

# Tworzenie nowego wpisu
wp post create --post_type=post --post_title="Tytuł wpisu" --post_status=draft

# Listowanie wpisów
wp post list

# Usuwanie wpisu
wp post delete ID

Operacje na bazie danych#

Eksport i import bazy danych#

# Eksport
wp db export backup.sql

# Import
wp db import backup.sql

Wyszukiwanie i zamiana w bazie danych#

Szczególnie użyteczne przy migracji strony:

wp search-replace 'http://stary-adres.pl' 'https://nowy-adres.pl' --all-tables

UWAGA: Przed wykonaniem operacji search-replace na produkcyjnej bazie danych, zalecamy zrobienie kopii zapasowej:

wp db export przed-zmiana.sql

Cache i optymalizacja#

Czyszczenie pamięci podręcznej (cache)#

Jeśli korzystasz z wtyczki cache:

wp cache flush

Dla wtyczki WP Super Cache:

wp super-cache flush

Optymalizacja bazy danych#

wp db optimize

Debugowanie i diagnostyka#

# Stan systemu
wp system-status check

# Weryfikacja plików WordPress
wp core verify-checksums

# Pełny raport
wp site info

Skrypty i automatyzacja#

Jedną z największych zalet WP-CLI jest możliwość tworzenia skryptów automatyzujących powtarzalne zadania. Oto przykład skryptu do pełnej aktualizacji WordPress, wtyczek i motywów.

Utwórz plik update-all.sh:

#!/bin/bash
cd public_html
wp core update
wp core update-db
wp plugin update --all
wp theme update --all
echo "Aktualizacja zakończona pomyślnie!"

Nadaj uprawnienia do wykonania:

chmod +x update-all.sh

Teraz możesz uruchomić skrypt jedną komendą:

./update-all.sh

Użyteczne sztuczki WP-CLI#

Generowanie danych testowych#

WP-CLI może wygenerować przykładowe treści do testów:

wp post generate --count=10 --post_type=post
wp user generate --count=5 --role=author

Masowe operacje na plikach#

Znajdowanie i usuwanie nieaktywnych wtyczek:

wp plugin list --status=inactive --format=json | jq -r '.[] | .name' | xargs -I % wp plugin delete %

Eksport treści#

Eksport wszystkich stron i postów do plików XML:

wp export

Porady dotyczące wydajności#

1. Unikaj WP-CLI dla bardzo długich operacji — niektóre zadania mogą trwać długo, a zamknięcie sesji SSH może przerwać ich wykonanie. W takich przypadkach używaj narzędzia screen lub tmux do utrzymania sesji.

2. Monitoruj użycie zasobów — niektóre operacje WP-CLI (np. search-replace na dużej bazie danych) mogą być intensywne zasobowo:

   top
   

3. Wykonuj kopie zapasowe — przed krytycznymi operacjami zawsze rób backup:

   wp db export backup-$(date +%F).sql
   

Rozwiązywanie problemów#

WP-CLI zwraca błąd „PHP Fatal error"#

Sprawdź wersję PHP używaną przez WP-CLI:

wp --info

Jeśli wersja PHP jest niekompatybilna z WordPressem lub wtyczkami, możesz wskazać inną wersję PHP:

/opt/php74/bin/php /usr/local/bin/wp --info

Problemy z uprawnieniami#

Jeśli masz problemy z uprawnieniami, sprawdź właściciela i grupę plików:

ls -la

W razie potrzeby zmień uprawnienia:

chmod 755 wp-content
chmod 644 wp-config.php

Powiązane artykuły#

• Jak zainstalować WordPress za pomocą Softaculous?
• Podstawowa optymalizacja wydajności WordPress
• Zabezpieczanie WordPressa — dobre praktyki
• Rozwiązywanie typowych błędów WordPress
• Jak skonfigurować dostęp SSH za pomocą kluczy?