Einrichten einer lokalen WordPress-Entwicklungsumgebung mit Vagrant

Wenn Sie mit WordPress entwickeln, ist es vorzuziehen, eine lokale Umgebung einzurichten, in der Sie einen Server, ein Datenbanktool und einige WordPress-Seiten sowie andere benötigte Tools installiert haben. Das ist in Ordnung, wenn Sie nur an wenigen Projekten arbeiten. Aber wenn sie sich vervielfachen, treten Probleme auf. Und auch die Kopfschmerzen bei der Wartung mehrerer Umgebungen, weil der Kunde eine andere Konfiguration hat als Sie.

Um dieses Problem zu umgehen, können wir das verwenden, was wir Vagrant nennen. Vagrant ist ein Tool zum Arbeiten mit virtuellen Umgebungen. Es bietet eine einfache Möglichkeit, eine lokale Entwicklungsumgebung mit wenigen Befehlen einzurichten, und Sie können ein komplettes Setup so oft wie gewünscht problemlos replizieren, ohne den Aufwand, alles manuell zu installieren. Um Vagrant auszuführen, müssen Sie eine Reihe von Regeln definieren. Vagrant richtet Ihre virtuelle Maschine basierend auf diesen Regeln ein. Vagrant benötigt dafür zwei Dateien: Vagrantfile, das Vagrant sagt, welche Art von Hardware die virtuelle Maschine benötigt, und eine Bereitstellungsdatei, die Vagrant sagt, was auf der virtuellen Maschine zu tun ist.

Da Vagrant mit virtuellen Umgebungen arbeitet, benötigen Sie Software für virtuelle Maschinen, um Vagrant auszuführen. Für unsere Zwecke verwenden wir das Open Source Virtualbox.

Installation von VirtualBox

Gehen Sie zur Download-Seite von Virtualbox und laden Sie eine Binärdatei herunter, die Ihrem Gastbetriebssystem entspricht. (Gastbetriebssystem ist das Betriebssystem, von dem aus Sie Ihre Entwicklungsumgebung ausführen werden.) Installieren Sie Virtualbox.

Installation von Vagrant

Laden Sie die Binärdatei, die Ihrem Betriebssystem entspricht, von der Download-Seite von Vagrant herunter und installieren Sie sie.

Um zu testen, ob es erfolgreich installiert wurde, geben Sie den folgenden Befehl in die Eingabeaufforderung Ihres Betriebssystems ein.

$ vagrant -v

Installation des Vagrant Hosts Updater Plugins

Das vagrant-hostupdater Plugin wird die Hosts-Datei Ihres Betriebssystems ändern, damit die von Vagrant eingerichteten Domains funktionieren. Um es zu installieren, führen Sie den folgenden Befehl aus

$ vagrant plugin install vagrant-hostsupdater

Starten Sie Ihr Betriebssystem nach der Installation von Vagrant/Virtualbox neu, damit es keine Netzwerkprobleme gibt.

Installation von Git

Linux

Wir benötigen auch die Versionskontrolle von Git für dieses Tutorial. Wenn Sie es nicht installiert haben, installieren Sie es mit dem folgenden Befehl, wenn Sie eine Debian/Ubuntu-Distribution haben

$ sudo apt install git

oder wenn Sie Fedora haben

$ sudo dnf install git

oder wenn Sie CentOS/RHEL haben

$ sudo yum install git

Überprüfen Sie die installierte Version von Git mit dem folgenden Befehl

$ git --version

Sie werden etwas sehen wie

$ git version 2.20.1

Sie müssen Git mit den folgenden Befehlen einrichten.

$ git config --global user.name "Ihr Name"   
$ git config --global user.email "[email protected]"

Windows

Um Git unter Windows zu installieren, gehen Sie zur Download-Seite von Git und installieren Sie die Binärdatei.

Mac OS

Wenn Sie Homebrew installiert haben, können Sie Git mit dem folgenden Befehl installieren.

$ brew install git

oder Sie können ein Binärpaket von der Download-Seite von Git herunterladen und installieren.

Installieren von Varying Vagrant Vagrants

Anstatt ein Vagrant-Setup von Grund auf neu zu erstellen, verwenden wir Varying Vagrants Vagrant (VVV) - eine Open-Source-Vagrant-Konfiguration, die speziell für die Erstellung von WordPress-Entwicklungsumgebungen entwickelt wurde. Ein Standard-VVV richtet Ihre virtuelle Maschine basierend auf Ubuntu 18.04 mit Nginx-Server, MariaDB-Datenbank, PHP, WP-CLI, Node.js, MailHog, Composer, memcached, phpMyAdmin, git und verschiedenen anderen Tools ein. VVV bietet Ihnen standardmäßig mehrere WordPress-Installationen, eine davon ist die neueste bleeding-edge Version, um Ihnen beim Experimentieren zu helfen.

Der erste Schritt besteht darin, das Git-Repository von VVV in ein lokales Verzeichnis auf Ihrem System zu klonen.

$ git clone -b master git://github.com/Varying-Vagrant-Vagrants/VVV.git ~/vvv

Hier klonen wir den Master-Zweig des Repositories auf das System. Wenn Sie schnellere Updates wünschen, können Sie den Entwicklungszweig verwenden.

Starten von VVV

Wechseln Sie in das Verzeichnis, in das Sie VVV geklont haben.

$ cd vvv

Starten Sie die Vagrant-Umgebung, die die virtuelle Maschine installiert und alles einrichtet.

$ vagrant up

Dieser Prozess kann eine Weile dauern, also haben Sie Geduld. Möglicherweise werden Sie während des Prozesses nach Ihrem Root-Passwort gefragt, das für die Einrichtung der Hosts-Datei Ihres Systems erforderlich ist.

Hinweis für Windows 8/10-Benutzer

Wenn Sie Windows verwenden, erhalten Sie möglicherweise den folgenden Fehler

==> default: Booting VM...   
Es gab einen Fehler beim Ausführen von `VBoxManage`, einem CLI, das von Vagrant verwendet wird   
zum Steuern von VirtualBox. Der Befehl und stderr sind unten angezeigt.   
   
Befehl: ["startvm", "1fe83aa1-2f23-4ddd-ad77-b7e7e00aabe6", "--type", "headless"]   
   
Stderr: VBoxManage.exe: Fehler: Konnte das interne Netzwerk 'HostInterfaceNetworking-VirtualBox Host-Only   
Ethernet Adapter #3' nicht öffnen/erstellen (VERR_INTNET_FLT_IF_NOT_FOUND).   
VBoxManage.exe: Fehler: Konnte das Netzwerk-LUN nicht anhängen (VERR_INTNET_FLT_IF_NOT_FOUND)   
VBoxManage.exe: Fehler: Einzelheiten: Code E_FAIL (0x80004005), Komponente ConsoleWrap, Schnittstelle IConsole

Beachten Sie den hier erwähnten Adapter:

VirtualBox Host-Only Ethernet Adapter #3

Öffnen Sie die Systemsteuerung >> Netzwerk- und Freigabecenter. Klicken Sie nun auf Adaptereinstellungen ändern. Klicken Sie mit der rechten Maustaste auf den Adapter, dessen Name oder Gerätename mit VirtualBox Host-Only Ethernet Adapter #3 übereinstimmt, und klicken Sie auf Eigenschaften. Klicken Sie auf die Schaltfläche Konfigurieren.

Klicken Sie nun auf die Registerkarte Treiber. Klicken Sie auf Treiber aktualisieren. Wählen Sie Durchsuchen Sie meinen Computer nach Treibern. Wählen Sie nun Lassen Sie mich aus einer Liste verfügbarer Treiber auf meinem Computer auswählen. Wählen Sie die Option, die Sie erhalten, und klicken Sie auf Weiter. Klicken Sie auf Schließen, um das Update abzuschließen. Gehen Sie nun zurück zu Ihrem Terminal/Powershell/Eingabeaufforderung und wiederholen Sie den vagrant up-Befehl. Es sollte diesmal gut funktionieren.

Sobald dies abgeschlossen ist, können Sie Ihr VVV-Dashboard unter der URL http://vvv.test besuchen.

VVV wird mit zwei standardmäßigen WordPress-Installationen geliefert - http://one.wordpress.test und http://two.wordpress.test Beide Seiten haben dieselben Anmeldedaten, admin als Benutzername und password als Passwort. Die Datenbankanmeldeinformationen für beide Seiten sind wp als Benutzername und Passwort. Die MySQL-Root-Benutzeranmeldeinformationen sind root als sowohl Benutzername als auch Passwort. Und die Anmeldeinformationen des Root-Benutzers der VM sind root als Benutzername und vagrant als Passwort.

Es gibt eine Entwickler-WordPress-Installation unter http://trunk.wordpress.net, aber sie wird nicht funktionieren, da sie nicht bereitgestellt wurde. Diese Installation ist nützlich, wenn Sie ein WordPress-Mitarbeiter sind, der mit Trac-Tickets und Patches arbeitet. Um sie zu aktivieren, öffnen Sie vvv-custom.yml und ändern Sie den Wert von skip_provisioning unter wordpress-trunk auf false und stellen Sie dann die VM mit dem Befehl wieder bereit

$ vagrant reload --provision

Es gibt eine weitere WordPress-Installation ohne URL, die als wordpress-meta-environment bezeichnet wird. Diese Installation erstellt eine Umgebung, die für Beiträge zum WordPress-Meta-Team nützlich ist, z. B. WordCamps, .org usw. Um diese Installation zu aktivieren, fügen Sie die folgende Zeile unter wordpress-meta-environment in der Datei vvv-custom.yml hinzu.

hosts:  
  - wpmeta.test

Ändern Sie dann den Wert von skip_provisioning auf false und stellen Sie die VM erneut bereit.

$ vagrant reload --provision

Hinzufügen einer neuen Site

Wenn Sie eine weitere Site zur VM hinzufügen möchten, müssen Sie die Datei vvv-custom.yml bearbeiten, die Sie im Verzeichnis vvv finden. Wenn sie nicht vorhanden ist, kopieren Sie einfach vvv-config.yml und erstellen Sie sie. Dies ist ein einmaliger Prozess, und Sie müssen es nicht erneut tun. Nehmen Sie immer Ihre Änderungen in vvv-custom.yml vor, da vvv-config.yml beim Aktualisieren von VVV überschrieben wird.

Fügen Sie den folgenden Code unter dem Abschnitt sites zu vvv-custom.yml hinzu, um eine neue Site hinzuzufügen.

newsite:
    repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template
    description: "Eine WordPress-Subdirectory-Multisite-Installation"  
    vm_dir: /srv/www/newsite  
    local_dir: /home/user/vvv/www/newsite  
    branch: master  
    nginx_upstream: php
    skip_provisioning: false
    hosts:
      - newsite.test
    custom:
      wp_type: subdirectory

Variablen

repo-Variable bezieht sich auf ein vordefiniertes Github-Repository, das Informationen zur Einrichtung einer neuen WordPress-Website auf der VM enthält. Für jetzt verwenden wir ein von VVV verwaltetes Repository.

description-Variable ist selbsterklärend.

vm_dir ist das tatsächliche Verzeichnis innerhalb der VM, in dem Ihre Site reside.

local_dir ist das Verzeichnis auf Ihrem Host-Computer, in dem Ihre Site lebt.

branch-Variable sagt Vagrant, dass es den Master-Zweig des Repos im Beispiel hier auschecken soll.

nginx_upstream wird verwendet, um festzulegen, wohin Nginx Anfragen weiterleitet, und wird normalerweise verwendet, um die benötigte PHP-Version für Ihre Installation zu ändern. php hier bezieht sich auf die Standard-PHP-Version, die 7.2 ist. Sie können php71 verwenden, um es auf PHP 7.1 zu ändern, oder php56, um es auf PHP 5.6 zu ändern.

skip_provisioning ist auf false gesetzt, was bedeutet, dass wir diese Site in die VM aufnehmen müssen.

hosts-Variable wird verwendet, um die URL festzulegen, die wir benötigen, um auf die Site zuzugreifen.

custom-Abschnitt ist nützlich, wenn Sie zusätzliche Kontrolle über Ihre WordPress-Website benötigen. Sie können diesen Abschnitt verwenden, um eine Multisite-Installation einzurichten oder eine andere Version von WordPress zu installieren und sogar den Namen der Datenbank oder Ihrer Site zu ändern, die für Ihre Installation verwendet wird.

wp_type-Variable entscheidet, ob Ihre Installation eine Einzel-, Multisite mit Domains oder Multisite mit Unterverzeichnis sein wird. wp_type nimmt vier Werte an: single, subdomain, subdirectory und none. Bei der Subdomain-Installation können Sie mehrere Hosts für Ihre Multisite-Installation im folgenden Format definieren

hosts:
    - multisite.test
    - site1.multisite.test
    - site2.multisite.test
  custom:
    wp_type: subdomain

Sie können eine weitere Variable unter dem benutzerdefinierten Abschnitt hinzufügen, die wp_version ist. Sie können sie auf nightly setzen, wenn Sie die Nightly-Version von WordPress installieren möchten. Es nimmt drei Werte an: nightly, latest und eine Versionsnummer.

custom: 
     wp_version: nightly

Es gibt eine weitere Variable, db_name, mit der Sie den Namen der Datenbank für Ihre Installation festlegen können.

custom:
    db_name: super_secet_db_name

Und schließlich ermöglicht die site_title-Variable, den Titel Ihrer WP-Website festzulegen.

custom:
    site_title: Meine großartige Entwicklungsseite

Dies sollte alle Variablen und Optionen abdecken, die Sie benötigen, um Ihre eigene Website in VVV hinzuzufügen. Nachdem Sie die Datei vvv-custom.yml geändert haben, führen Sie einfach den folgenden Befehl aus, um Ihre neue Site zum Laufen zu bringen.

$ vagrant reload --provision

Hinzufügen einer vorhandenen Site

Bisher haben wir gelernt, wie man eine völlig neue Site zu VVV hinzufügt. Aber was ist, wenn Sie bereits an einer Site arbeiten und sie unter VVV hinzufügen möchten? Lassen Sie uns sehen, wie wir das tun können.

Um eine vorhandene Site hinzuzufügen, ist der erste Schritt derselbe wie zuvor, d. h. die Datei vvv-custom.yml zu bearbeiten und den folgenden Code hinzuzufügen.

howtoforge:
    repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template
    description: "Eine WordPress-Website"  
    vm_dir: /srv/www/newsite  
    local_dir: /home/user/vvv/www/newsite  
    hosts:
      - howtoforge.local

Dies wird VVV sagen, eine neue Site einzurichten, die über http://howtoforge.local zugänglich ist. Aber es ist eine völlig neue Site. Was wir tun müssen, ist, sie in unsere vorhandene Installation umzuwandeln. Dazu müssen wir die Dateien von unserer vorhandenen WordPress-Installation in das lokale Verzeichnis /home/user/vvv/www/newsite kopieren.

$ cp /var/www/howtoforge/ /home/user/vvv/www/newsite/

Jetzt müssen wir die Datenbank kopieren. Eine einfache Möglichkeit, dies zu tun, besteht darin, Ihre vorhandene Datenbank als .sql-Datei zu exportieren, diese Datei in das Verzeichnis Ihres Blogs zu kopieren und die Datenbank erneut zu importieren, indem Sie sich per SSH in Ihre VM einloggen.

Zuerst melden Sie sich in der Befehlszeile Ihres lokalen Systems bei mysql an und verwenden Sie den folgenden Befehl, um die Datenbank zu exportieren.

$ cd /home/user/vvv/www/newsite
$ mysqldump -u benutzername -p datenbank_name > data-dump.sql

Jetzt können wir die VM erneut bereitstellen.

$ vagrant reload --provision

SSH in Ihre VM.

$ vagrant ssh

Jetzt importieren Sie die Datenbank zurück in Ihre VM.

$ cd /srv/www/newsite 
$ mysql -u root -p newsite < data-dump.sql

VVV hat bereits während der Bereitstellung eine neue Datenbank für unseren Blog mit dem Namen newsite erstellt. Das Passwort für den Root-Benutzer ist hier root. Der obige Befehl importiert unsere vorhandene Datenbank in die neue.

Damit ist die Einrichtung einer vorhandenen Site in VVV abgeschlossen.

SSL aktivieren

localhost-Installationen sind normalerweise nicht gesichert. Und das Installieren Ihres eigenen Zertifikats auf localhost kann ein langwieriger und mühsamer Prozess sein, selbst mit Let’s Encrypt. Aber VVV macht diesen Prozess ziemlich einfach und hat standardmäßig SSL auf allen Ihren WordPress-Installationen aktiviert. Verwenden Sie einfach https mit Ihren Sites. Beim ersten Mal wird Ihr Browser sich über ein ungültiges Zertifikat beschweren, aber fügen Sie es als Ausnahme hinzu, und es sollte von nun an in Ordnung sein.

WordPress aktualisieren

Sie können Ihre WordPress-Installation von Ihrem Dashboard aus aktualisieren. Außerdem wird VVV Ihr WordPress aktualisieren, wann immer Sie die VM erneut bereitstellen. Sie können WordPress auch manuell aktualisieren, indem Sie es von WordPress.org herunterladen und die Zip-Datei extrahieren. Und Sie können auch WP CLI verwenden, das mit VVV gebündelt ist. Um Ihre Site mit WP CLI zu aktualisieren, verwenden Sie die folgenden Befehle.

$ cd /srv/www/newsite
$ wp core update

VVV aktualisieren

Der erste Schritt besteht darin, die Vagrant-Maschine zu stoppen.

$ vagrant halt

Stellen Sie nun sicher, dass Ihr Vagrant und Virtualbox auf dem neuesten Stand sind. Wenn nicht, laden Sie sie erneut herunter und installieren Sie sie.

Führen Sie den folgenden Befehl aus, um Ihre Vagrant-Box zu aktualisieren. Es ist optional, aber es ist am besten, wenn Sie damit fortfahren.

$ vagrant box update

Ziehen Sie nun die neueste VVV-Version von Github.

$ git pull

Stellen Sie die Box erneut bereit, um das Update abzuschließen.

$ vagrant up --provision

Zusätzliche Tools

VVV wird mit verschiedenen Dienstprogrammen geliefert, die Sie installieren können. Sie finden sie im Abschnitt Dienstprogramme in Ihrer vvv-custom.yml-Datei aufgelistet. Standardmäßig sind tls-ca und phpmyadmin aktiviert. Sie können auch memcached, opcache, webgrind, mongodb, tideways und PHP-Versionen von 5.6 bis 7.3 installieren, indem Sie das # vor ihnen im Abschnitt Dienstprogramme entfernen.

Sie können sogar Ihre eigene Software hinzufügen, die Sie installieren möchten. Sie müssen die Datei vvv-custom.yml mit etwas wie

utilities:
  core:
    - tls-ca  
    - phpmyadmin
  java:
    - java7
utility-sources:
  java:
    repo: https://github.com/example/java-utilities.git
    branch: master

Sie fügen hier beispielsweise einen neuen Abschnitt java hinzu. Der Code für die Installation stammt aus einem Git-Repository. Ihr Git-Repository sollte so strukturiert sein

java7/
    provision.sh

Die provision.sh-Datei enthält den notwendigen Code, um Java in Ihrer VM zu installieren. Der Name des Ordners sollte mit dem Namen übereinstimmen, den Sie oben in der vvv-custom.yml-Datei verwendet haben.

Fazit

Damit endet unser Tutorial, wie man eine lokale WordPress-Entwicklungsumgebung mit Vagrant einrichtet. Lassen Sie uns wissen, wenn Sie Fragen haben.