wp-env unter Windows mit schneller Performance (WSL2 & Ubuntu)

Heute möchte ich euch zeigen, wie ihr wp-env unter Windows nutzen könnt, ohne dabei auf Performance verzichten zu müssen. Die Performance kann unter Windows bei der Verwendung von Docker und einem gemounteten Dateisystem leiden. Um dieses Problem zu umgehen, werden wir Ubuntu mit WSL2 installieren, Docker den Zugriff aus WSL2 ermöglichen und unsere Entwicklungsumgebung innerhalb des Ubuntu-Dateisystems einrichten.

Folgt diesen Schritten, um WSL2 und Ubuntu unter Windows einzurichten:

1. Installiert WSL2 gemäß dieser Anleitung.
2. Ladet Ubuntu (oder ein anderes Linux-Betriebssystem) aus dem Microsoft Store herunter und installiert es.
3. Startet Ubuntu zum ersten Mal und richtet es gegebenenfalls ein.
4. Installiert Docker gemäß der offiziellen Installationsseite.
5. Öffnet Docker Desktop und navigiert in den Einstellungen zu „Resources“ und dann zum Unterpunkt „WSL Integration“. Aktiviert hier Ubuntu.

6. Im Windows Explorer sollte nun ein Linux-Tab vorhanden sein, in dem ihr den Ubuntu-Ordner findet. Der Pfad sieht beispielsweise so aus: \wsl.localhost\Ubuntu
7. Navigiert in den Benutzerordner und erstellt dort einen Workspace-Ordner. In meinem Fall sieht der Pfad so aus:
   \…\home\oliver\PhpstormProjects

Die meisten modernen IDEs bieten Unterstützung für WSL2. Hier findet ihr das VS Code-Plugin und die Dokumentation für JetBrains-Produkte.

Nun führt die folgenden Schritte aus, um NodeJS und wp-env zu installieren:

1. Öffnet die Ubuntu-Konsole (z. B. in der IDE oder über die Windows-App „Ubuntu“).
2. Installiert NodeJS, zum Beispiel mit nvm.sh.
3. Widmet euch wp-env und der offiziellen Dokumentation.
4. Installiert wp-env global mit dem Befehl: npm -g i @wordpress/env

Erstellt nun im zuvor erstellten Workspace einen neuen Ordner und wechselt in diesen hinein. Bei mir wäre es

mkdir \...\home\oliver\PhpstormProjects\wp-theme
cd \...\home\oliver\PhpstormProjects\wp-theme

Startet wp-env im neuen Ordner mit dem Befehl:

wp-env start

Nachdem der Docker-Prozess abgeschlossen ist, wird die URL zu eurer WordPress-Instanz in der Konsole angezeigt (http://localhost:8888) sowie der Admin-Account:

Username: admin Password: password

Viel Spaß beim Entwickeln mit wp-env unter Windows und Ubuntu!