Instalacja i użycie WP-CLI w systemie Windows

Kompletny przewodnik: czym jest WP-CLI, do czego służy, jak je zainstalować, skonfigurować i używać w systemie Windows.

---

Czym jest WP-CLI

WP-CLI (WordPress Command Line Interface) to narzędzie wiersza poleceń do zarządzania stronami WordPress bez użycia przeglądarki.

Pozwala na:

• instalację i aktualizację WordPressa,
• zarządzanie wtyczkami, motywami i użytkownikami,
• wyszukiwanie i zastępowanie treści w bazie danych,
• automatyzację zadań za pomocą skryptów.

Oficjalna strona: https://wp-cli.org

---

Dlaczego warto używać WP-CLI

Zalety WP-CLI:

• Automatyzacja — umożliwia pisanie skryptów do operacji masowych.
• Szybkość — praca w konsoli jest szybsza niż przez panel administracyjny.
• Elastyczność — zarządzanie WordPressem nawet bez interfejsu graficznego.
• Bezpieczeństwo — można wyłączyć panel administratora i pracować tylko z terminala.

---

Wymagania

• PHP 7.4 lub nowszy (zalecany 8.x)
• WordPress 3.7 lub nowszy
• PHP CLI musi być dostępny w zmiennej PATH
• Połączenie z Internetem do pobrania plików

Sprawdzenie PHP:

php -v

---

Instalacja WP-CLI w systemie Windows

1. Pobierz wp-cli.phar

Otwórz PowerShell i wpisz:

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

(Możesz też pobrać plik ręcznie i umieścić go w C:\wp-cli\.)

---

2. Sprawdź, czy działa

php C:\wp-cli\wp-cli.phar --info

Jeśli wyświetlą się informacje o wersji, WP-CLI działa poprawnie.

---

3. Utwórz plik wp.bat

Utwórz plik C:\wp-cli\wp.bat o następującej treści:

@ECHO OFF
php "%~dp0wp-cli.phar" %*

Teraz możesz uruchamiać WP-CLI poleceniem wp.

---

4. Dodaj do PATH

Aby można było uruchamiać wp z dowolnego katalogu:

setx PATH "$($env:PATH);C:\wp-cli" /M

Uruchom ponownie PowerShell i sprawdź:

wp --info

Jeśli komenda działa — instalacja zakończona sukcesem.

---

Alternatywa: instalacja przez Composer

composer global require wp-cli/wp-cli

Następnie dodaj ścieżkę:

%USERPROFILE%\AppData\Roaming\Composer\vendor\bin

---

Użycie WP-CLI

Przykładowe polecenia:

Instalacja WordPressa:

wp core download --locale=pl_PL

Tworzenie pliku wp-config.php:

wp config create --dbname=wordpress --dbuser=root --dbpass=secret

Instalacja strony:

wp core install --url="http://localhost" --title="Moja Strona" --admin_user=admin --admin_password=1234 --admin_email=test@example.com

Aktualizacje:

wp core update
wp plugin update --all

Użytkownicy:

wp user create redaktor redaktor@example.com --role=editor --user_pass=pass123

---

Przydatne polecenia

• wp plugin list — lista zainstalowanych wtyczek
• wp theme list — lista motywów
• wp search-replace "http://stary" "https://nowy" — masowa zamiana treści
• wp db export / wp db import — eksport/import bazy danych
• wp shell — interaktywna konsola PHP

Pełna lista: https://developer.wordpress.org/cli/commands/

---

Skrypt PowerShell do automatycznej instalacji

Zapisz jako install-wp-cli.ps1 i uruchom jako administrator:

$targetDir = "C:\wp-cli"
$pharUrl   = "https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar"
$pharPath  = "$targetDir\wp-cli.phar"
$batPath   = "$targetDir\wp.bat"

Write-Host "Instalowanie WP-CLI..." -ForegroundColor Cyan

if (!(Test-Path $targetDir)) {
    New-Item -ItemType Directory -Force -Path $targetDir | Out-Null
}

Invoke-WebRequest -Uri $pharUrl -OutFile $pharPath

"@ECHO OFF
php ""%~dp0wp-cli.phar"" %*" | Out-File $batPath -Encoding ASCII

$envPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($envPath -notlike "*$targetDir*") {
    [Environment]::SetEnvironmentVariable("Path", "$envPath;$targetDir", "Machine")
    Write-Host "✅ Dodano $targetDir do PATH (uruchom ponownie terminal)" -ForegroundColor Green
}

php $pharPath --info

Po uruchomieniu możesz sprawdzić:

wp --info

---

Wskazówki

• Uruchamiaj PowerShell jako administrator, jeśli modyfikujesz PATH.
• Dla zdalnych stron używaj --ssh=<użytkownik>@<host>.
• W przypadku błędów SSL dodaj --skip-ssl-check.
• Przed masowymi operacjami wykonaj kopię zapasową bazy danych.

---

Podsumowanie

WP-CLI to potężne narzędzie dla administratorów i deweloperów WordPressa.
Oszczędza czas, automatyzuje procesy i sprawia, że zarządzanie stroną jest bezpieczniejsze i bardziej efektywne.

Autor: hypo69
Licencja: MIT (https://opensource.org/licenses/MIT)