WP-CLI — zarządzanie WordPress z terminala

Opublikowano: 8 kwietnia 2026 · Kategoria: WordPress

WP-CLI (WordPress Command Line Interface) to oficjalne narzędzie do zarządzania WordPress z wiersza poleceń przez SSH. Pozwala aktualizować rdzeń, instalować wtyczki, migrować bazy danych i zarządzać użytkownikami bez logowania do panelu WP-Admin — szybciej i z możliwością automatyzacji przez cron.

Instalacja WP-CLI

Na serwerze VPS lub hostingu z dostępem SSH (jako root lub użytkownik z sudo):

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

# Nadaj uprawnienia wykonywania
chmod +x wp-cli.phar

# Zainstaluj globalnie
sudo mv wp-cli.phar /usr/local/bin/wp

# Weryfikacja instalacji
wp --info

Na hostingu współdzielonym (bez sudo) zainstaluj lokalnie:

mkdir -p ~/bin
mv wp-cli.phar ~/bin/wp
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
wp --info

Podstawowe komendy WP-CLI

Instalacja i aktualizacja WordPress

# Instalacja WordPress od zera
wp core download --locale=pl_PL
wp config create --dbname=mydb --dbuser=myuser --dbpass=secret
wp core install --url=https://example.com --title="Moja strona" \
  --admin_user=admin [email protected]

# Aktualizacja rdzenia WordPress
wp core update
wp core update-db

# Sprawdzenie wersji
wp core version

Zarządzanie wtyczkami

# Lista wszystkich wtyczek (z informacją o dostępnych aktualizacjach)
wp plugin list

# Instalacja i aktywacja wtyczki
wp plugin install woocommerce --activate

# Aktualizacja wszystkich wtyczek jednocześnie
wp plugin update --all

# Dezaktywacja i usunięcie wtyczki
wp plugin deactivate akismet
wp plugin delete akismet

# Aktualizacja tylko wybranych wtyczek
wp plugin update woocommerce yoast-seo

Zarządzanie motywami

# Lista motywów
wp theme list

# Instalacja i aktywacja motywu
wp theme install astra --activate

# Aktualizacja wszystkich motywów
wp theme update --all

Zarządzanie użytkownikami

# Lista użytkowników
wp user list

# Tworzenie administratora
wp user create admin2 [email protected] --role=administrator --user_pass=BezpieczneHaslo123

# Reset hasła administratora (ratunkowe)
wp user update 1 --user_pass=NoweHaslo123

# Usunięcie użytkownika
wp user delete 5 --reassign=1

Operacje na bazie danych

# Eksport bazy danych
wp db export backup-$(date +%Y%m%d).sql

# Import bazy danych
wp db import backup-20260409.sql

# Optymalizacja tabel (naprawia fragmentację)
wp db optimize

# Sprawdzenie spójności bazy
wp db check

# Wyszukaj i zamień URL (migracja domeny)
wp search-replace "http://stara-domena.pl" "https://nowa-domena.pl" --all-tables

Komenda search-replace jest nieoceniona przy migracji WordPress na nową domenę — aktualizuje wszystkie URLe w bazie danych (posty, metadane, opcje, widżety) jednym poleceniem, łącznie z serializowanymi danymi PHP.

Cache i optymalizacja

# Czyszczenie cache WordPress (object cache, transients)
wp cache flush

# Usunięcie wygasłych transients z bazy
wp transient delete --expired

# Regeneracja miniatur obrazków
wp media regenerate --yes

# Czyszczenie opcji autoload (optymalizacja bazy)
wp option list --autoload=yes --format=table

WP-CLI w automatyzacji (cron)

WP-CLI świetnie nadaje się do automatyzacji przez cron. Przykład automatycznej aktualizacji wtyczek co tydzień (VPS/hosting z SSH):

# crontab -e
# Co niedziela o 3:00 — aktualizacja wtyczek + eksport bazy
0 3 * * 0 /usr/local/bin/wp --path=/var/www/html plugin update --all --quiet 2>&1 | logger -t wp-update
0 3 * * 0 /usr/local/bin/wp --path=/var/www/html db export /backup/wp-$(date +\%Y\%m\%d).sql --quiet

Przydatne opcje globalne

Najczęstsze pytania