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
Apri PowerShell come amministratore
Nel menu Start cerca “PowerShell” e seleziona “Esegui come amministratore”.
Installa WSL e Ubuntu
Il comando installa WSL 2 e Ubuntu (distribuzione predefinita). Al termine, riavvia il PC. 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.
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.
Installa i pacchetti richiesti
sudo apt install -y software-properties-common
Aggiungi il PPA ondrej/php
sudo add-apt-repository ppa:ondrej/php
sudo apt update
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
Verifica la versione
Se viene mostrato PHP 8.3.x o superiore, è tutto ok. (Facoltativo) Cambiare tra più versioni
Se ti servono più versioni di PHP, puoi cambiarle con update-alternatives.sudo update-alternatives --config php
Installazione di Composer
Installa Composer tramite l’installer ufficiale.
Verifica i pacchetti richiesti
sudo apt install -y curl php8.3-cli unzip
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
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"
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.
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
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"
~/.zshrc e applicale con source ~/.zshrc.
Installazione di Node.js
Impostala come predefinita
Imposta la versione predefinita in modo che venga usata automaticamente anche nelle nuove sessioni del terminale. Verifica le versioni
node --version
npm --version
Verifica dell’installazione di Laravel
Installa l'installer di Laravel
composer global require laravel/installer
Crea un nuovo progetto
Parte il setup interattivo. Puoi selezionare lo starter kit, l’autenticazione e altre opzioni. Avvia il server di sviluppo
cd my-app
php artisan serve
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.
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 .
