Wie kann ich WordPress mit WP-CLI im HOSTFACTORY® Standard Webhosting nutzen?

Mit WP-CLI können Sie Ihre WordPress-Installation direkt über die Kommandozeile (SSH) verwalten. Dadurch lassen sich Updates, Plugin-Verwaltung oder Datenbank-Operationen effizient und ohne Login ins WordPress-Backend durchführen.

Welche Voraussetzungen sind erforderlich?

WP-CLI ist auf den HOSTFACTORY® Standard Webhostings bereits serverseitig installiert und muss nicht separat eingerichtet werden.
Für die Nutzung von WP-CLI benötigen Sie somit lediglich:

• Ein HOSTFACTORY® Standard Webhosting
• Aktivierten SSH-Zugang unter: my.hostfactory.ch » 'Webhostings' » (allf. Webhosting wählen) » (Domainaccount wählen) » 'FTP / SSH' » 'SSH/SFTP aktivieren' » (Checkbox «SSH aktiviert» aktivieren)
• Eine bestehende WordPress-Installation
• Die SSH-Zugangsdaten des entsprechenden Domain-Accounts

Wie stelle ich eine SSH-Verbindung her?

1. Öffnen Sie einen SSH-Client (z.B. Terminal unter macOS/Linux oder PuTTY unter Windows).
2. Stellen Sie die Verbindung zu Ihrem Webhosting her. Der Servername entspricht in der Regel dem im Kunden-Center angegebenen Host (z.B. serverXX.hostfactory.ch).
3. Melden Sie sich mit den SSH-Zugangsdaten Ihres Domain-Accounts an (abrufbar unter: my.hostfactory.ch » 'Webhostings' » (allf. Webhosting wählen) » (Domainaccount wählen) » 'FTP / SSH' » 'SSH/SFTP konfigurieren').
4. Wechseln Sie in das Verzeichnis Ihrer WordPress-Installation. In der Regel befindet sich diese im Ordner:

1. cd httpdocs

Falls sich Ihre WordPress-Installation in einem Unterordner befindet (z.B. blog oder shop), wechseln Sie entsprechend in dieses Verzeichnis:

1. cd httpdocs/blog

Wie prüfe ich, ob WP-CLI verfügbar ist?

Im WordPress-Verzeichnis können Sie mit folgendem Befehl prüfen, ob WP-CLI verfügbar ist:

1. wp --info

Wird eine Versions- und Systeminformation angezeigt, ist WP-CLI korrekt eingerichtet.

Welche Einstellung ist für den Datenbank-Host erforderlich?

Damit WP-CLI korrekt auf die Datenbank zugreifen kann, muss in der Datei wp-config.php der Datenbank-Host auf 127.0.0.1 gesetzt sein.

Beispiel:

1. define( 'DB_HOST', '127.0.0.1' );

Falls dort localhost eingetragen ist, ersetzen Sie diesen Wert durch 127.0.0.1.

Welche Befehle stehen zur Verfügung?
Eine vollständige und stets aktuelle Übersicht aller verfügbaren Befehle und Optionen finden Sie in der offiziellen Dokumentation: WP-CLI Befehlsübersicht

Warum ist diese Anpassung notwendig?

Wird localhost verwendet, versucht das System eine Verbindung über einen lokalen MySQL-Socket herzustellen. Diese Verbindungsart steht bei der Nutzung von WP-CLI im SSH-Umfeld nicht zur Verfügung. Durch die Verwendung von 127.0.0.1 wird stattdessen eine TCP/IP-Verbindung genutzt, welche sowohl für die Website als auch für WP-CLI korrekt funktioniert. Die Anpassung hat keine negativen Auswirkungen auf den normalen Betrieb Ihrer Website.

Ist weiterhin localhost gesetzt, kann z.B. folgende Meldung erscheinen:

1. Error establishing a database connection
2. Can't connect to local MySQL server through socket

Erstellen Sie vor der Anpassung der Datei wp-config.php vorsorglich eine Sicherungskopie.

Was sollte ich bei der Nutzung von WP-CLI beachten?

• Führen Sie WP-CLI-Befehle immer im Verzeichnis der gewünschten WordPress-Installation aus.
• Erstellen Sie vor grösseren Änderungen (z.B. Updates oder Such- und Ersetzoperationen) ein Backup.
• Bei mehreren WordPress-Installationen innerhalb eines Webhostings ist besondere Vorsicht geboten, um nicht die falsche Installation zu bearbeiten.
• Der SSH-Zugang ermöglicht weitreichende Änderungen. Geben Sie die Zugangsdaten nur an vertrauenswürdige Personen weiter.

Wo finde ich weitere Informationen zu WP-CLI?
Offizielle Dokumentation zu WP-CLI: WP-CLI The command line interface for WordPress