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
• eine bestehende WordPress-Installation
• einen aktivierten SSH-Zugang für den betreffenden Domain Account
• eine Freigabe Ihrer IP-Adresse für den SSH-Zugang

Wie aktiviere ich den SSH-Zugang?

Öffnen Sie die SSH-Einstellungen Ihres Domain Accounts über einen der folgenden Wege:

my.hostfactory.ch » 'Webhostings' » (Webhosting wählen) » (Domain Account wählen) » 'Mehr' » 'Einstellungen' » 'SSH-Zugang'

oder

my.hostfactory.ch » 'Webhostings' » (Webhosting wählen) » (Domain Account wählen) » 'FTP / SSH verwalten' » 'SSH/SFTP aktivieren'

Ist SSH bereits aktiv, heisst die Schaltfläche im zweiten Weg "SSH/SFTP konfigurieren". Aktivieren Sie auf der Seite "SSH/SFTP Zugang" den Schalter "SSH aktiviert".

Wie gebe ich meine IP-Adresse für den SSH-Zugang frei?

Aus Sicherheitsgründen ist der SSH-Zugang auf die HOSTFACTORY® Server durch eine Firewall eingeschränkt. Bevor Sie sich verbinden können, geben Sie deshalb Ihre aktuelle öffentliche IP-Adresse frei. Klicken Sie dazu auf derselben Seite auf "IP-Adresse zulassen":

my.hostfactory.ch » 'Webhostings' » (Webhosting wählen) » (Domain Account wählen) » 'Mehr' » 'Einstellungen' » 'SSH-Zugang' » 'IP-Adresse zulassen'

Geben Sie dort Ihre IP-Adresse ein, wählen Sie unter "Gültigkeit", wie lange die Freigabe bestehen soll, und bestätigen Sie mit "Zulassen". Ihre aktuelle IP-Adresse können Sie unter meineip.hostfactory.ch abfragen.

Hinweis: Freigeben können Sie jeweils nur eine einzelne IP-Adresse, keine ganzen Netzbereiche. Verbinden sich mehrere Geräte oder ein externer Dienst (z.B. ein Deployment-Dienst) von verschiedenen IP-Adressen aus, erfassen Sie für jede dieser Adressen eine eigene Freigabe.

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. Den Hostnamen, den Port (22) sowie Benutzer und Passwort finden Sie im Abschnitt "Info" der SSH-Einstellungen: my.hostfactory.ch » 'Webhostings' » (Webhosting wählen) » (Domain Account wählen) » 'Mehr' » 'Einstellungen' » 'SSH-Zugang'
3. Melden Sie sich mit diesen Zugangsdaten an. Der SSH-Zugang ist ausschliesslich mit diesem Hauptbenutzer des Domain Accounts möglich, nicht mit zusätzlichen FTP-Benutzern.
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 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

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.

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

Beispiel:

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

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

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

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

Bei weiteren Fragen zu diesem Thema hilft Ihnen der HOSTFACTORY® Support gerne weiter.