Installation und Verwendung von WP-CLI unter Windows

Ein vollständiger Leitfaden: Was ist WP-CLI, wofür wird es verwendet, wie installiert, konfiguriert und genutzt man es unter Windows.

Was ist WP-CLI

WP-CLI (WordPress Command Line Interface) ist ein Befehlszeilenwerkzeug zur Verwaltung von WordPress-Websites ohne Verwendung eines Browsers.

Es ermöglicht:

die Installation und Aktualisierung von WordPress,
die Verwaltung von Plugins, Themes und Benutzern,
Such- und Ersetzvorgänge in der Datenbank,
die Automatisierung wiederkehrender Aufgaben über Skripte.

Offizielle Website: https://wp-cli.org

Warum es nützlich ist

Vorteile von WP-CLI:

Automatisierung — Sie können Skripte für Massenoperationen erstellen.
Geschwindigkeit — Die Arbeit über die Befehlszeile ist schneller als die grafische Oberfläche.
Flexibilität — Verwaltung von WordPress auch ohne Weboberfläche.
Sicherheit — Das Admin-Panel kann deaktiviert werden, sodass nur über die Konsole gearbeitet wird.

Voraussetzungen

PHP 7.4 oder höher (empfohlen 8.x)
WordPress 3.7 oder höher
PHP CLI muss in der Systemvariablen PATH vorhanden sein
Internetverbindung zum Herunterladen der Dateien

PHP überprüfen:

php -v

Installation von WP-CLI unter Windows

1. `wp-cli.phar` herunterladen

Öffnen Sie PowerShell und führen Sie aus:

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

(Alternativ können Sie die Datei manuell herunterladen und in C:\wp-cli\ speichern.)

2. Funktion überprüfen

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

Wenn Versionsinformationen angezeigt werden, funktioniert WP-CLI korrekt.

3. `wp.bat` erstellen

Erstellen Sie die Datei C:\wp-cli\wp.bat mit folgendem Inhalt:

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

Nun können Sie WP-CLI einfach mit wp ausführen.

4. Zum PATH hinzufügen

Damit Sie wp von überall aus verwenden können:

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

Starten Sie PowerShell neu und überprüfen Sie:

wp --info

Wenn die Ausgabe korrekt ist, ist die Installation abgeschlossen.

Alternative: Installation über Composer

composer global require wp-cli/wp-cli

Fügen Sie anschließend den Pfad hinzu:

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

Verwendung von WP-CLI

Beispiele für Befehle:

WordPress installieren:

wp core download --locale=de_DE

wp-config.php erstellen:

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

Website installieren:

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

Updates:

wp core update
wp plugin update --all

Benutzerverwaltung:

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

Nützliche Befehle

wp plugin list — listet installierte Plugins auf
wp theme list — listet Themes auf
wp search-replace "http://alt" "https://neu" — Massen-Suchen und Ersetzen
wp db export / wp db import — Datenbank sichern und wiederherstellen
wp shell — interaktive PHP-Shell öffnen

Komplette Befehlsliste: https://developer.wordpress.org/cli/commands/

PowerShell-Skript zur automatischen Installation

Speichern Sie dieses Skript als install-wp-cli.ps1 und führen Sie es als Administrator aus:

$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 "WP-CLI wird installiert..." -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 "✅ $targetDir wurde zum PATH hinzugefügt (Konsole neu starten)" -ForegroundColor Green
}

php $pharPath --info

Nach der Ausführung können Sie prüfen:

wp --info

Tipps

Führen Sie PowerShell als Administrator aus, wenn Sie den PATH ändern.
Für entfernte Websites verwenden Sie --ssh=<benutzer>@<host>.
Bei SSL-Fehlern: --skip-ssl-check hinzufügen.
Vor größeren Änderungen immer ein Datenbank-Backup erstellen.

Fazit

WP-CLI ist ein leistungsstarkes Werkzeug für WordPress-Administratoren und Entwickler.
Es spart Zeit, automatisiert Abläufe und macht die Verwaltung sicherer und effizienter.

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