Introduction
Pour développer avec Laravel sous Windows, la meilleure pratique consiste à utiliser WSL (Windows Subsystem for Linux). Vous pouvez utiliser la chaîne d’outils Linux telle quelle, ce qui permet d’exécuter les mêmes commandes que sur macOS ou sur un serveur de production.
Ce guide explique comment installer PHP, Composer et Node.js (via nvm) sur Ubuntu dans WSL 2, jusqu’à obtenir un état où laravel new fonctionne.
Environnement cible : Windows 10 (version 2004 ou ultérieure) ou Windows 11. WSL 2 est utilisé.
Installation de WSL
Ouvrez PowerShell en tant qu'administrateur
Recherchez « PowerShell » dans le menu Démarrer et choisissez « Exécuter en tant qu’administrateur ».
Installez WSL et Ubuntu
Cette commande installe WSL 2 et Ubuntu (la distribution par défaut). Redémarrez le PC une fois l’opération terminée. Configurez Ubuntu
Après le redémarrage, Ubuntu démarre automatiquement. Définissez un nom d’utilisateur et un mot de passe. Ce mot de passe sera utilisé avec la commande sudo.Le mot de passe ne s’affiche pas à l’écran pendant la saisie. Saisissez-le avec précision.
Mettez à jour la liste des paquets
Exécutez ce qui suit dans le terminal Ubuntu.sudo apt update && sudo apt upgrade -y
Installation de PHP
Les dépôts standard d’Ubuntu peuvent contenir une version ancienne de PHP. Nous installons la dernière version en utilisant le PPA ondrej/php.
Installez les paquets nécessaires
sudo apt install -y software-properties-common
Ajoutez le PPA ondrej/php
sudo add-apt-repository ppa:ondrej/php
sudo apt update
Installez PHP 8.3 et les extensions nécessaires
Laravel 13 nécessite PHP 8.3 ou supérieur.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
Vérifiez la version
Si PHP 8.3.x ou une version supérieure s’affiche, l’installation a réussi. (Optionnel) Basculer entre plusieurs versions
Si vous avez besoin de plusieurs versions de PHP, vous pouvez les commuter avec update-alternatives.sudo update-alternatives --config php
Installation de Composer
Composer s’installe avec l’installeur officiel.
Vérifiez les paquets requis
sudo apt install -y curl php8.3-cli unzip
Téléchargez et exécutez l'installeur officiel
curl -sS https://getcomposer.org/installer -o /tmp/composer-setup.php
sudo php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer
Configurez le PATH pour l'installation globale
Pour pouvoir utiliser les paquets installés avec composer global require (comme l’installateur Laravel), ajoutez ~/.composer/vendor/bin à votre PATH.Ajoutez ce qui suit à ~/.bashrc (ou ~/.zshrc).export PATH="$HOME/.composer/vendor/bin:$PATH"
Installation de nvm
Node.js est installé par utilisateur avec nvm (Node Version Manager). Il ne nécessite pas sudo et permet une bonne compatibilité avec les outils IA et CLI utilisant des paquets npm globaux.
Installez nvm
Vous pouvez consulter le script d’installation le plus récent sur le dépôt GitHub de nvm.curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
Ajoutez la configuration au fichier de shell
Le script d’installation ajoute automatiquement ce qui suit à ~/.bashrc. Si ce n’est pas le cas, ajoutez-le manuellement.export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
~/.zshrc et rechargez avec source ~/.zshrc.
Installation de Node.js
Définissez la version par défaut
Définissez la version par défaut pour qu’elle soit automatiquement utilisée dans les nouvelles sessions de terminal. Vérifiez les versions
node --version
npm --version
Vérification de l’installation de Laravel
Installez l'installateur Laravel
composer global require laravel/installer
Créez un nouveau projet
Un assistant interactif démarre. Vous pouvez choisir le starter kit et l’inclusion ou non de l’authentification. Démarrez le serveur de développement
cd my-app
php artisan serve
http://localhost:8000 dans votre navigateur ; si la page d’accueil de Laravel s’affiche, tout est terminé.Si vous ne pouvez pas accéder à localhost depuis le navigateur Windows via WSL, essayez de démarrer avec php artisan serve --host=0.0.0.0.
Annexe : outils pour améliorer la productivité
Windows Terminal
Avec Windows Terminal, vous pouvez gérer WSL, PowerShell et l’invite de commandes dans plusieurs onglets à partir d’une interface unifiée. Il est disponible gratuitement sur le Microsoft Store.
- Utilisation parallèle de plusieurs shells dans des onglets
- Possibilité de définir le shell Ubuntu par défaut
- Police et palette de couleurs entièrement personnalisables
Extension VS Code Remote - WSL
Avec l’extension Remote - WSL de VS Code, vous pouvez éditer les fichiers de WSL directement depuis VS Code sur Windows.
# Ouvrir le projet dans VS Code depuis le terminal WSL
code .
