Vai al contenuto principale

Introduzione

Il team di Laravel mette a disposizione Herd e php.new per chi inizia, ma gli ingegneri senior preferiscono gestire ciascuno strumento singolarmente con un package manager. Così puoi controllare tu stesso le versioni ed è facile passare da una versione di PHP all’altra tra più progetti. Questa guida spiega come usare Homebrew per installare PHP, Composer e Node.js (tramite nvm) fino ad avere laravel new funzionante.
Ambiente di riferimento: macOS 13 Ventura o superiore. Compatibile sia con Apple Silicon (M1/M2/M3) sia con Intel.

Installazione di Homebrew

Homebrew è il package manager per macOS. Se non lo hai ancora installato, esegui nel terminale:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Dopo l’installazione, su Apple Silicon la seguente riga viene aggiunta automaticamente al file di configurazione della shell (per esempio ~/.zprofile). Se l’hai aggiunta manualmente, ricarica la configurazione.
eval "$(/opt/homebrew/bin/brew shellenv)"
Verifica l’installazione.
brew --version

Installazione di PHP

1

Installa l'ultima versione di PHP

La formula php di Homebrew punta sempre all’ultima versione stabile. Laravel 13 richiede PHP 8.3 o superiore.
brew install php
2

Verifica la versione

php --version
Se viene mostrato PHP 8.3.x o superiore, è tutto ok.
3

(Facoltativo) usa una versione specifica

Se vuoi gestire più versioni di PHP, installa la formula con la versione.
brew install [email protected]
Per cambiare versione usa brew link.
brew unlink php
brew link [email protected] --force --overwrite
Verifica quale versione è attualmente linkata.
php --version

Installazione di Composer

1

Installa Composer

Puoi installarlo direttamente da Homebrew.
brew install composer
2

Verifica la versione

composer --version
3

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 la riga seguente in ~/.zshrc (o ~/.bashrc).
export PATH="$HOME/.composer/vendor/bin:$PATH"
Applica la configurazione.
source ~/.zshrc

Installazione di nvm

Installa Node.js a livello utente usando nvm (Node Version Manager). Poiché non richiede privilegi di root, si integra bene con strumenti AI e CLI che usano pacchetti npm globali.
1

Installa nvm

Lo script di installazione più recente lo trovi sul 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 a ~/.zshrc (o ~/.bashrc) quanto segue. Se non è stato aggiunto, fallo 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 ~/.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.

Homebrew o Herd, come scegliere

Setup manuale con HomebrewHerd
Utente tipicoSviluppatori che vogliono controllare in dettaglio versioni e configurazioniPrincipianti o singoli sviluppatori che vogliono partire velocemente
Cambio versione PHPManuale con brew linkCambio facile tramite GUI
Domini localiModifica manuale di /etc/hostsImpostazione automatica di domini .test
Gestione servizibrew servicesAvvio/arresto da GUI
PersonalizzazioneAltaLimitata
Il setup manuale con Homebrew è indicato quando vuoi allineare la configurazione con lo sviluppo di team o l’ambiente CI, o cambiare spesso tra più versioni di PHP.
Ultima modifica il 13 luglio 2026