PHP, Composer und Node.js mit WSL installieren (Windows)

Schritt-für-Schritt-Anleitung zur Installation von PHP, Composer und Node.js mit WSL 2 unter Windows 10/11 und zur Einrichtung der Laravel-Entwicklungsumgebung.

​

Einleitung

Für die Laravel-Entwicklung unter Windows ist der Einsatz von WSL (Windows Subsystem for Linux) die Best Practice. Sie nutzen die Linux-Toolchain unmittelbar; dieselben Kommandos wie auf macOS oder Produktionsservern stehen bereit.

Dieser Leitfaden erklärt, wie Sie unter Ubuntu auf WSL 2 PHP, Composer und Node.js (via nvm) installieren, bis laravel new läuft.

Zielumgebung: Windows 10 (ab Version 2004) oder Windows 11. Wir verwenden WSL 2.

---

​

WSL installieren

1. PowerShell als Administrator öffnen

   Suchen Sie im Startmenü nach „PowerShell” und wählen Sie „Als Administrator ausführen”.

2. WSL und Ubuntu installieren

   wsl --install
   

   Damit werden WSL 2 und Ubuntu (die Default-Distribution) installiert. Starten Sie danach den PC neu.

3. Ubuntu einrichten

   Nach dem Neustart startet Ubuntu automatisch. Legen Sie Benutzername und Passwort fest. Dieses Passwort wird für sudo verwendet.

   Das Passwort wird während der Eingabe nicht angezeigt. Achten Sie auf korrekte Eingabe.

4. Paketliste aktualisieren

   Führen Sie im Ubuntu-Terminal aus:

   sudo apt update && sudo apt upgrade -y
   

---

​

PHP installieren

Das PHP in den Ubuntu-Standard-Repositories ist häufig veraltet. Verwenden Sie das PPA ondrej/php für die neueste Version.

1. Notwendige Pakete installieren

   sudo apt install -y software-properties-common
   
2. PPA ondrej/php hinzufügen

   sudo add-apt-repository ppa:ondrej/php
   sudo apt update
   
3. PHP 8.3 und benötigte Extensions installieren

   Laravel 13 setzt PHP 8.3 oder höher voraus.

   sudo apt install -y php8.3 php8.3-cli php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip php8.3-sqlite3 php8.3-mysql
   
4. Version prüfen

   php --version
   

   Erscheint PHP 8.3.x oder höher, war die Installation erfolgreich.

5. (Optional) Zwischen mehreren Versionen wechseln

   Wenn Sie mehrere PHP-Versionen benötigen, wechseln Sie diese mit update-alternatives.

   sudo update-alternatives --config php
   

   Es wird eine Liste installierter Versionen angezeigt; geben Sie die Nummer der zu verwendenden Version ein.

---

​

Composer installieren

Composer installieren Sie mit dem offiziellen Installer.

1. Benötigte Pakete prüfen

   sudo apt install -y curl php8.3-cli unzip
   
2. Offiziellen Installer laden und ausführen

   curl -sS https://getcomposer.org/installer -o /tmp/composer-setup.php
   sudo php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer
   
3. Version prüfen

   composer --version
   
4. Pfad für globale Installationen einrichten

   Damit Pakete, die Sie per composer global require installieren (z. B. der Laravel-Installer), nutzbar sind, ergänzen Sie ~/.composer/vendor/bin in PATH.

   Fügen Sie in ~/.bashrc (oder ~/.zshrc) Folgendes hinzu:

   export PATH="$HOME/.composer/vendor/bin:$PATH"
   

   Konfiguration übernehmen:

   source ~/.bashrc
   

---

​

nvm installieren

Node.js wird pro Benutzer per nvm (Node Version Manager) installiert. Ohne sudo verwaltbar und ideal für KI-Tools und CLIs, die globale npm-Pakete voraussetzen.

1. nvm installieren

   Das aktuelle Installations-Skript finden Sie im nvm-GitHub-Repository.

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
   
2. Shell-Konfiguration ergänzen

   Das Installations-Skript ergänzt in ~/.bashrc automatisch Folgendes. Falls nicht, tragen Sie es manuell ein.

   export NVM_DIR="$HOME/.nvm"
   [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
   [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
   

   Übernehmen Sie die Konfiguration:

   source ~/.bashrc
   

   Bei zsh tragen Sie das Gleiche in ~/.zshrc ein und übernehmen es per source ~/.zshrc.

3. Installation prüfen

   nvm --version
   

---

​

Node.js installieren

1. LTS-Version installieren

   nvm install --lts
   
2. Als Default setzen

   Damit die Version auch in neuen Terminal-Sessions verwendet wird, setzen Sie die Default-Version.

   nvm alias default node
   
3. Version prüfen

   node --version
   npm --version
   

---

​

Laravel-Installation prüfen

1. Laravel-Installer einrichten

   composer global require laravel/installer
   
2. Neues Projekt anlegen

   laravel new my-app
   

   Das interaktive Setup startet. Sie können Starterkits und Authentifizierungsoptionen wählen.

3. Entwicklungsserver starten

   cd my-app
   php artisan serve
   

   Öffnen Sie im Browser http://localhost:8000. Erscheint die Laravel-Welcome-Seite, ist alles bereit.

   Falls Sie aus WSL heraus im Windows-Browser nicht auf localhost zugreifen können, starten Sie mit php artisan serve --host=0.0.0.0.

---

​

Zusatz: Werkzeuge zur Produktivitätssteigerung

​

Windows Terminal

Mit Windows Terminal verwalten Sie WSL, PowerShell und die Eingabeaufforderung in mehreren Tabs. Kostenlos aus dem Microsoft Store zu beziehen.

• parallele Nutzung mehrerer Shells über Tabs
• Ubuntu-Shell als Default festlegbar
• Schriftarten und Farben frei anpassbar

​

VS-Code-Erweiterung Remote - WSL

Mit der Remote-WSL-Erweiterung für VS Code bearbeiten Sie Dateien im WSL direkt aus dem Windows-VS-Code.

# Projekt aus dem WSL-Terminal in VS Code öffnen
code .

Beim ersten Aufruf wird der VS-Code-Server automatisch im WSL installiert. Danach fühlt sich die Entwicklung nativ an.