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
PowerShell als Administrator öffnen
Suchen Sie im Startmenü nach „PowerShell” und wählen Sie „Als Administrator ausführen”.
WSL und Ubuntu installieren
Damit werden WSL 2 und Ubuntu (die Default-Distribution) installiert. Starten Sie danach den PC neu. 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.
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.
Notwendige Pakete installieren
sudo apt install -y software-properties-common
PPA ondrej/php hinzufügen
sudo add-apt-repository ppa:ondrej/php
sudo apt update
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
Version prüfen
Erscheint PHP 8.3.x oder höher, war die Installation erfolgreich. (Optional) Zwischen mehreren Versionen wechseln
Wenn Sie mehrere PHP-Versionen benötigen, wechseln Sie diese mit update-alternatives.sudo update-alternatives --config php
Composer installieren
Composer installieren Sie mit dem offiziellen Installer.
Benötigte Pakete prüfen
sudo apt install -y curl php8.3-cli unzip
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
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"
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.
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
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"
~/.zshrc ein und übernehmen es per source ~/.zshrc.
Node.js installieren
Als Default setzen
Damit die Version auch in neuen Terminal-Sessions verwendet wird, setzen Sie die Default-Version. Version prüfen
node --version
npm --version
Laravel-Installation prüfen
Laravel-Installer einrichten
composer global require laravel/installer
Neues Projekt anlegen
Das interaktive Setup startet. Sie können Starterkits und Authentifizierungsoptionen wählen. Entwicklungsserver starten
cd my-app
php artisan serve
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 .
Zuletzt geändert am 13. Juli 2026
