Passer au contenu principal

​
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 [email protected]
Pour changer de version, utilisez brew link.
brew unlink php
brew link [email protected] --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
PublicDéveloppeurs qui veulent contrôler finement les versions et la configurationDébutants et solos qui veulent démarrer vite
Changement de version PHPManuel avec brew linkSimple via GUI
Domaines locauxÉdition manuelle de /etc/hostsDomaines .test configurés automatiquement
Gestion des servicesbrew servicesDémarrage/arrêt via GUI
PersonnalisationÉlevéeLimité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.
Dernière modification le 13 juillet 2026

Sujets connexes

Installer PHP, Composer et Node.js avec WSL (Windows)Laravel SailInstallationBundling des assets avec ViteConstruire une SPA avec Inertia.js