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 z dostępem SSH — SSH jest w pakietach HS5 i wyższych (HS1 nie ma SSH). WP-CLI 2.12 jest zainstalowane na serwerach, niczego nie musisz doinstalowywać.
2. Klucza SSH dodanego w DirectAdmin — do SSH logujesz się wyłącznie kluczem, patrz Klucze SSH i dostęp 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.pl
   

   gdzie hostXXXX to login Twojego konta, a hostXXXX.iqhs.pl — domena techniczna. Oba znajdziesz w panelu IQHost na stronie usługi. Port to standardowy 22 (nie 2222 — to port panelu DirectAdmin).

3. Uwierzytelnienie odbywa się kluczem SSH — hasła do SSH nie podajesz. Na Windowsie z PuTTY: Połączenie przez SSH w PuTTY.

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 (zastąp twoja-domena.pl swoją domeną):

cd ~/domains/twoja-domena.pl/public_html

Lub jeśli WordPress jest zainstalowany w podkatalogu:

cd ~/domains/twoja-domena.pl/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 LiteSpeed Cache (pełne czyszczenie cache strony):

wp litespeed-purge all

Optymalizacja bazy danych#

wp db optimize

Debugowanie i diagnostyka#

# Środowisko: wersje PHP i WP-CLI, ścieżki
wp --info

# Wersja WordPressa z bazą danych i TinyMCE
wp core version --extra

# Czy pliki rdzenia i wtyczek nie zostały zmienione (np. po infekcji)
wp core verify-checksums
wp plugin verify-checksums --all

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 ~/domains/twoja-domena.pl/public_html || exit 1
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 delete $(wp plugin list --status=inactive --field=name)

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 uruchom je w programie screen (jest dostępny na serwerach): screen, potem polecenie; od sesji odłączysz się skrótem Ctrl+A, D, a wrócisz do niej poleceniem screen -r.

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

WP-CLI używa wersji PHP ustawionej dla konta w Select PHP version. Jeśli domena ma inną wersję z IQhost PHP Changer, wskaż ją ręcznie — np. dla PHP 8.3:

/opt/alt/php83/usr/bin/php /usr/local/bin/wp --info

W ścieżce zmień php83 na potrzebną wersję (php74, php82, php84 itd.).

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#

• Instalacja WordPressa przez Softaculous
• Optymalizacja WordPress
• Zabezpieczenie WordPressa
• Klucze SSH i dostęp SSH
• Połączenie przez SSH w PuTTY (Windows)