Installare PHP, Composer e Node.js con Homebrew (macOS)

Guida passo passo per installare PHP, Composer e Node.js con Homebrew su macOS e configurare l’ambiente di sviluppo Laravel.

​

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 php@8.3
   

   Per cambiare versione usa brew link.

   brew unlink php
   brew link php@8.3 --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 Homebrew	Herd
Utente tipico	Sviluppatori che vogliono controllare in dettaglio versioni e configurazioni	Principianti o singoli sviluppatori che vogliono partire velocemente
Cambio versione PHP	Manuale con brew link	Cambio facile tramite GUI
Domini locali	Modifica manuale di /etc/hosts	Impostazione automatica di domini .test
Gestione servizi	brew services	Avvio/arresto da GUI
Personalizzazione	Alta	Limitata

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.