Skip to main content

Inleiding

Voor Laravel-ontwikkeling op Windows is het gebruik van WSL (Windows Subsystem for Linux) de best practice. Je kunt de Linux-toolchain rechtstreeks gebruiken, waardoor dezelfde commando’s werken als op macOS of je productieserver. In deze gids leggen we uit hoe je op Ubuntu binnen WSL 2 PHP, Composer en Node.js (via nvm) installeert, tot en met het punt waarop laravel new werkt.
Doelomgeving: Windows 10 (versie 2004 of nieuwer) of Windows 11. We gebruiken WSL 2.

WSL installeren

1

PowerShell als administrator openen

Zoek in het startmenu naar “PowerShell” en kies “Als administrator uitvoeren”.
2

WSL en Ubuntu installeren

Dit commando installeert WSL 2 en Ubuntu (de standaarddistributie). Start je pc opnieuw op zodra dit klaar is.
3

Ubuntu instellen

Na de herstart start Ubuntu automatisch. Stel een gebruikersnaam en wachtwoord in. Dit wachtwoord gebruik je voor het sudo-commando.
Het wachtwoord wordt tijdens het typen niet op het scherm getoond. Typ het zorgvuldig in.
4

Pakketlijst bijwerken

Voer het volgende uit in de Ubuntu-terminal.

PHP installeren

De standaardrepository van Ubuntu bevat soms een verouderde PHP-versie. We installeren de nieuwste versie via de PPA ondrej/php.
1

Benodigde pakketten installeren

2

De ondrej/php PPA toevoegen

3

PHP 8.3 en de benodigde extensies installeren

Laravel 13 vereist PHP 8.3 of hoger.
4

Versie controleren

Als er PHP 8.3.x of hoger wordt getoond, is het gelukt.
5

(Optioneel) Wisselen tussen meerdere versies

Heb je meerdere PHP-versies nodig, dan kun je wisselen met update-alternatives.
Er verschijnt een lijst met geïnstalleerde versies; voer het nummer in van de versie die je wilt gebruiken.

Composer installeren

Composer installeer je met de officiële installer.
1

Benodigde pakketten controleren

2

De officiële installer downloaden en uitvoeren

3

Versie controleren

4

Het pad voor globale installaties instellen

Voeg ~/.composer/vendor/bin toe aan je PATH, zodat je pakketten kunt gebruiken die je met composer global require installeert (zoals de Laravel installer).Voeg het volgende toe aan ~/.bashrc (of ~/.zshrc).
Laad de configuratie opnieuw.

nvm installeren

Node.js installeer je per gebruiker met nvm (Node Version Manager). Omdat je het zonder sudo kunt beheren, werkt het goed samen met AI-tools en CLI’s die globale npm-pakketten gebruiken.
1

nvm installeren

Het nieuwste installatiescript vind je in de GitHub-repository van nvm.
2

Toevoegen aan je shell-configuratiebestand

Het installatiescript voegt automatisch het volgende toe aan ~/.bashrc. Is dat niet gebeurd, voeg het dan handmatig toe.
Laad de configuratie opnieuw.
Gebruik je zsh, voeg het dan op dezelfde manier toe aan ~/.zshrc en herlaad met source ~/.zshrc.
3

Installatie controleren


Node.js installeren

1

De LTS-versie installeren

2

Als standaard instellen

Stel de standaardversie in, zodat die ook automatisch wordt gebruikt in nieuwe terminalsessies.
3

Versie controleren


Laravel-installatie controleren

1

De Laravel installer installeren

2

Een nieuw project aanmaken

Er start een interactieve setup. Je kunt onder meer een starter kit kiezen en aangeven of je authenticatie wilt.
3

De ontwikkelserver starten

Open http://localhost:8000 in je browser. Zie je de welkomstpagina van Laravel, dan ben je klaar.
Als je vanuit een Windows-browser geen toegang krijgt tot localhost in WSL, probeer dan te starten met php artisan serve --host=0.0.0.0.

Extra: tools die je ontwikkelefficiëntie verhogen

Windows Terminal

Met Windows Terminal beheer je WSL, PowerShell en de opdrachtprompt centraal in meerdere tabs. Je installeert het gratis via de Microsoft Store.
  • Meerdere shells parallel bedienen in tabs
  • De Ubuntu-shell instellen als standaard
  • Lettertype en kleuren vrij aanpasbaar

VS Code Remote - WSL-extensie

Met de Remote - WSL-extensie van VS Code kun je bestanden binnen WSL rechtstreeks bewerken vanuit VS Code op Windows.
Bij de eerste keer uitvoeren wordt de VS Code-server automatisch geïnstalleerd binnen WSL. Daarna ontwikkel je met een ervaring die gelijkwaardig is aan native.
Laatst gewijzigd op 6 september 2026