Installer PHP, Composer et Node.js avec WSL (Windows)

Guide pas à pas pour préparer un environnement de développement Laravel en installant PHP, Composer et Node.js avec WSL 2 sur Windows 10/11.

​

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

1. Ouvrez PowerShell en tant qu'administrateur

   Recherchez « PowerShell » dans le menu Démarrer et choisissez « Exécuter en tant qu’administrateur ».

2. Installez WSL et Ubuntu

   wsl --install
   

   Cette commande installe WSL 2 et Ubuntu (la distribution par défaut). Redémarrez le PC une fois l’opération terminée.

3. 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.

4. 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.

1. Installez les paquets nécessaires

   sudo apt install -y software-properties-common
   
2. Ajoutez le PPA ondrej/php

   sudo add-apt-repository ppa:ondrej/php
   sudo apt update
   
3. 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
   
4. Vérifiez la version

   php --version
   

   Si PHP 8.3.x ou une version supérieure s’affiche, l’installation a réussi.

5. (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
   

   Une liste des versions installées s’affiche ; entrez le numéro de la version que vous souhaitez utiliser.

---

​

Installation de Composer

Composer s’installe avec l’installeur officiel.

1. Vérifiez les paquets requis

   sudo apt install -y curl php8.3-cli unzip
   
2. 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
   
3. Vérifiez la version

   composer --version
   
4. 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"
   

   Rechargez la configuration.

   source ~/.bashrc
   

---

​

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.

1. 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
   
2. 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"
   

   Rechargez la configuration.

   source ~/.bashrc
   

   Si vous utilisez zsh, ajoutez la même chose à ~/.zshrc et rechargez avec source ~/.zshrc.

3. Vérifiez l'installation

   nvm --version
   

---

​

Installation de Node.js

1. Installez la version LTS

   nvm install --lts
   
2. 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.

   nvm alias default node
   
3. Vérifiez les versions

   node --version
   npm --version
   

---

​

Vérification de l’installation de Laravel

1. Installez l'installateur Laravel

   composer global require laravel/installer
   
2. Créez un nouveau projet

   laravel new my-app
   

   Un assistant interactif démarre. Vous pouvez choisir le starter kit et l’inclusion ou non de l’authentification.

3. Démarrez le serveur de développement

   cd my-app
   php artisan serve
   

   Ouvrez 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 .

Lors du premier lancement, le serveur VS Code s’installe automatiquement dans WSL. Ensuite, vous développez avec une expérience équivalente à un environnement natif.