Installare PHP, Composer e Node.js con WSL (Windows)

Guida passo passo per installare PHP, Composer e Node.js con WSL 2 su Windows 10/11 e configurare l’ambiente di sviluppo Laravel.

​

Introduzione

Per sviluppare Laravel su Windows la best practice è usare WSL (Windows Subsystem for Linux). Puoi usare direttamente le toolchain Linux e i comandi sono gli stessi che usi su macOS e sui server di produzione.

Questa guida spiega come installare PHP, Composer e Node.js (via nvm) su Ubuntu in WSL 2 fino ad avere laravel new funzionante.

Ambienti di riferimento: Windows 10 (versione 2004 o superiore) o Windows 11. Si usa WSL 2.

---

​

Installazione di WSL

1. Apri PowerShell come amministratore

   Nel menu Start cerca “PowerShell” e seleziona “Esegui come amministratore”.

2. Installa WSL e Ubuntu

   wsl --install
   

   Il comando installa WSL 2 e Ubuntu (distribuzione predefinita). Al termine, riavvia il PC.

3. Configura Ubuntu

   Dopo il riavvio, Ubuntu si avvia automaticamente. Imposta nome utente e password. Questa password verrà usata con il comando sudo.

   La password non viene mostrata a schermo mentre la digiti. Digitala con attenzione.

4. Aggiorna l'elenco dei pacchetti

   Nel terminale Ubuntu esegui:

   sudo apt update && sudo apt upgrade -y
   

---

​

Installazione di PHP

Il PHP nei repository standard di Ubuntu può includere versioni datate. Usa il PPA ondrej/php per installare l’ultima versione.

1. Installa i pacchetti richiesti

   sudo apt install -y software-properties-common
   
2. Aggiungi il PPA ondrej/php

   sudo add-apt-repository ppa:ondrej/php
   sudo apt update
   
3. Installa PHP 8.3 e le estensioni necessarie

   Laravel 13 richiede PHP 8.3 o superiore.

   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. Verifica la versione

   php --version
   

   Se viene mostrato PHP 8.3.x o superiore, è tutto ok.

5. (Facoltativo) Cambiare tra più versioni

   Se ti servono più versioni di PHP, puoi cambiarle con update-alternatives.

   sudo update-alternatives --config php
   

   Viene mostrato l’elenco delle versioni installate: inserisci il numero della versione da usare.

---

​

Installazione di Composer

Installa Composer tramite l’installer ufficiale.

1. Verifica i pacchetti richiesti

   sudo apt install -y curl php8.3-cli unzip
   
2. Scarica ed esegui l'installer ufficiale

   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. Verifica la versione

   composer --version
   
4. Configura il PATH degli install globali

   Aggiungi ~/.composer/vendor/bin al PATH per poter usare i pacchetti installati con composer global require (come l’installer di Laravel).

   Aggiungi in ~/.bashrc (o ~/.zshrc):

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

   Applica la configurazione.

   source ~/.bashrc
   

---

​

Installazione di nvm

Installa Node.js a livello utente con nvm (Node Version Manager). Non richiede sudo, quindi si integra bene con strumenti AI e CLI che usano pacchetti npm globali.

1. Installa nvm

   Lo script di installazione più recente è disponibile nel repository GitHub di nvm.

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
   
2. Aggiungi le righe alla configurazione della shell

   Lo script di installazione aggiunge automaticamente le righe seguenti a ~/.bashrc. Se non le trovi, aggiungile manualmente.

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

   Applica la configurazione.

   source ~/.bashrc
   

   Se usi zsh, aggiungi le stesse righe a ~/.zshrc e applicale con source ~/.zshrc.

3. Verifica l'installazione

   nvm --version
   

---

​

Installazione di Node.js

1. Installa la versione LTS

   nvm install --lts
   
2. Impostala come predefinita

   Imposta la versione predefinita in modo che venga usata automaticamente anche nelle nuove sessioni del terminale.

   nvm alias default node
   
3. Verifica le versioni

   node --version
   npm --version
   

---

​

Verifica dell’installazione di Laravel

1. Installa l'installer di Laravel

   composer global require laravel/installer
   
2. Crea un nuovo progetto

   laravel new my-app
   

   Parte il setup interattivo. Puoi selezionare lo starter kit, l’autenticazione e altre opzioni.

3. Avvia il server di sviluppo

   cd my-app
   php artisan serve
   

   Apri http://localhost:8000 nel browser: se vedi la pagina di benvenuto di Laravel, hai finito.

   Se non riesci ad accedere a localhost dal browser Windows verso WSL, prova ad avviare con php artisan serve --host=0.0.0.0.

---

​

Extra: strumenti per aumentare l’efficienza dello sviluppo

​

Windows Terminal

Con Windows Terminal puoi gestire in un unico posto, in schede, WSL, PowerShell e Prompt dei comandi. Puoi installarlo gratuitamente dal Microsoft Store.

• Più shell in parallelo tramite schede
• Puoi impostare la shell Ubuntu come predefinita
• Personalizzazione libera di font e colori

​

Estensione VS Code Remote - WSL

Con l’estensione Remote - WSL di VS Code puoi modificare i file all’interno di WSL direttamente da VS Code su Windows.

# Apri il progetto in VS Code dal terminale WSL
code .

Alla prima esecuzione il server di VS Code viene installato automaticamente in WSL. Da quel momento sviluppi con un’esperienza equivalente al nativo.