Installer PHP, Composer et Node.js avec Homebrew (macOS)

Guide pas à pas pour installer PHP, Composer et Node.js avec Homebrew sur macOS et préparer un environnement de développement Laravel.

​

Introduction

L’équipe Laravel propose Herd ou php.new pour les débutants, mais les ingénieurs seniors préfèrent souvent gérer chaque outil individuellement avec un gestionnaire de paquets. Vous contrôlez vous-même les versions et vous pouvez facilement basculer entre plusieurs versions de PHP selon les projets.

Ce guide explique comment installer PHP, Composer et Node.js (via nvm) avec Homebrew jusqu’à obtenir un environnement où laravel new fonctionne.

Environnement cible : macOS 13 Ventura ou supérieur. Compatible Apple Silicon (M1/M2/M3) et Intel.

---

​

Installation de Homebrew

Homebrew est le gestionnaire de paquets pour macOS. S’il n’est pas encore installé, exécutez la commande suivante dans le terminal.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Après l’installation, sur Apple Silicon, la ligne suivante est ajoutée automatiquement au fichier de configuration du shell (par exemple ~/.zprofile). Si vous l’avez ajoutée à la main, rechargez la configuration.

eval "$(/opt/homebrew/bin/brew shellenv)"

Vérifiez l’installation.

brew --version

---

​

Installation de PHP

1. Installer la dernière version de PHP

   La formule Homebrew php pointe toujours vers la dernière version stable. Laravel 13 nécessite PHP 8.3 ou supérieur.

   brew install php
   
2. Vérifier la version

   php --version
   

   L’affichage de PHP 8.3.x ou supérieur confirme le succès.

3. (optionnel) Utiliser une version spécifique

   Pour gérer plusieurs versions, installez la formule avec le numéro de version.

   brew install php@8.3
   

   Pour changer de version, utilisez brew link.

   brew unlink php
   brew link php@8.3 --force --overwrite
   

   Vérifiez la version actuellement liée.

   php --version
   

---

​

Installation de Composer

1. Installer Composer

   Vous pouvez l’installer directement via Homebrew.

   brew install composer
   
2. Vérifier la version

   composer --version
   
3. Configurer le chemin des installations globales

   Pour utiliser les paquets installés via composer global require (comme l’installer Laravel), ajoutez ~/.composer/vendor/bin à votre PATH.

   Ajoutez la ligne suivante à ~/.zshrc (ou ~/.bashrc).

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

   Rechargez la configuration.

   source ~/.zshrc
   

---

​

Installation de nvm

Installez Node.js par utilisateur avec nvm (Node Version Manager). Comme il ne nécessite pas les droits root, il est très compatible avec les outils AI ou CLI qui utilisent des paquets npm globaux.

1. Installer nvm

   Le script d’installation le plus récent se trouve sur le dépôt GitHub de nvm.

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
   
2. Ajouter les lignes au fichier de configuration du shell

   Le script ajoute automatiquement les lignes ci-dessous à ~/.zshrc (ou ~/.bashrc). Ajoutez-les à la main si ce n’est pas le cas.

   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 ~/.zshrc
   
3. Vérifier l'installation

   nvm --version
   

---

​

Installation de Node.js

1. Installer la version LTS

   nvm install --lts
   
2. La définir par défaut

   Pour que la version soit utilisée automatiquement dans une nouvelle session de terminal, définissez-la par défaut.

   nvm alias default node
   
3. Vérifier la version

   node --version
   npm --version
   

---

​

Vérification de l’installation Laravel

1. Installer l'installer Laravel

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

   laravel new my-app
   

   Un setup interactif démarre. Vous pouvez y choisir un starter kit, activer ou non l’authentification, etc.

3. Démarrer le serveur de développement

   cd my-app
   php artisan serve
   

   Ouvrez http://localhost:8000 dans le navigateur : si la page d’accueil Laravel s’affiche, l’installation est terminée.

---

​

Homebrew vs Herd

	Homebrew (installation manuelle)	Herd
Public	Développeurs qui veulent contrôler finement les versions et la configuration	Débutants et solos qui veulent démarrer vite
Changement de version PHP	Manuel avec brew link	Simple via GUI
Domaines locaux	Édition manuelle de /etc/hosts	Domaines .test configurés automatiquement
Gestion des services	brew services	Démarrage/arrêt via GUI
Personnalisation	Élevée	Limitée

Pour aligner la configuration avec le développement en équipe ou l’environnement CI, ou pour basculer souvent entre plusieurs versions de PHP, l’installation manuelle via Homebrew est plus adaptée.