PHP, Composer und Node.js mit Homebrew installieren (macOS)

Schritt-für-Schritt-Anleitung zur Installation von PHP, Composer und Node.js mit Homebrew unter macOS und zur Einrichtung der Laravel-Entwicklungsumgebung.

​

Einleitung

Das Laravel-Team stellt für Einsteiger Herd sowie php.new bereit; Senior Engineers bevorzugen jedoch häufig, die einzelnen Werkzeuge separat mit einem Paketmanager zu verwalten. So kontrollieren Sie Versionen selbst und wechseln in mehreren Projekten leicht zwischen unterschiedlichen PHP-Versionen.

Dieser Leitfaden erklärt, wie Sie PHP, Composer und Node.js (via nvm) mit Homebrew installieren, bis laravel new läuft.

Zielumgebung: macOS 13 Ventura oder höher. Läuft sowohl auf Apple Silicon (M1/M2/M3) als auch auf Intel.

---

​

Homebrew installieren

Homebrew ist ein Paketmanager für macOS. Falls noch nicht installiert, führen Sie folgenden Befehl im Terminal aus:

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

Bei Apple Silicon wird nach der Installation automatisch die folgende Zeile in eine Shell-Konfigurationsdatei (z. B. ~/.zprofile) eingetragen. Falls Sie sie manuell hinzufügen, laden Sie die Konfiguration neu.

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

Überprüfen Sie die Installation:

brew --version

---

​

PHP installieren

1. Aktuelles PHP installieren

   Die php-Formel von Homebrew verweist stets auf die aktuelle stabile Version. Laravel 13 benötigt PHP 8.3 oder höher.

   brew install php
   
2. Version prüfen

   php --version
   

   Erscheint PHP 8.3.x oder höher, war die Installation erfolgreich.

3. (Optional) Eine bestimmte Version verwenden

   Wenn Sie mehrere PHP-Versionen verwalten möchten, installieren Sie eine versionierte Formel.

   brew install php@8.3
   

   Wechseln Sie die Version mit brew link.

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

   Prüfen Sie die aktuell verknüpfte Version.

   php --version
   

---

​

Composer installieren

1. Composer installieren

   Die Installation ist direkt über Homebrew möglich.

   brew install composer
   
2. Version prüfen

   composer --version
   
3. Pfad für globale Installationen einrichten

   Damit Pakete, die Sie per composer global require installieren (z. B. der Laravel-Installer), nutzbar sind, ergänzen Sie ~/.composer/vendor/bin in PATH.

   Fügen Sie in ~/.zshrc (oder ~/.bashrc) Folgendes ein:

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

   Konfiguration übernehmen:

   source ~/.zshrc
   

---

​

nvm installieren

Node.js wird pro Benutzer per nvm (Node Version Manager) installiert. Ohne root-Rechte lässt es sich sauber verwalten und harmoniert gut mit KI-Tools oder CLIs, die auf globale npm-Pakete zugreifen.

1. nvm installieren

   Das aktuelle Installations-Skript finden Sie im nvm-GitHub-Repository.

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
   
2. Shell-Konfiguration ergänzen

   Das Installations-Skript ergänzt in ~/.zshrc (oder ~/.bashrc) automatisch Folgendes. Falls nicht, tragen Sie es manuell ein.

   export NVM_DIR="$HOME/.nvm"
   [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
   [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
   

   Übernehmen Sie die Konfiguration:

   source ~/.zshrc
   
3. Installation prüfen

   nvm --version
   

---

​

Node.js installieren

1. LTS-Version installieren

   nvm install --lts
   
2. Als Default setzen

   Damit die Version auch in neuen Terminal-Sessions verwendet wird, setzen Sie die Default-Version.

   nvm alias default node
   
3. Version prüfen

   node --version
   npm --version
   

---

​

Laravel-Installation prüfen

1. Laravel-Installer einrichten

   composer global require laravel/installer
   
2. Neues Projekt anlegen

   laravel new my-app
   

   Das interaktive Setup startet. Sie können Starterkits und Authentifizierungsoptionen auswählen.

3. Entwicklungsserver starten

   cd my-app
   php artisan serve
   

   Öffnen Sie im Browser http://localhost:8000. Erscheint die Laravel-Welcome-Seite, ist alles bereit.

---

​

Wann Homebrew, wann Herd?

	Manueller Aufbau mit Homebrew	Herd
Zielgruppe	Entwickler, die Versionen und Konfiguration granular steuern möchten	Einsteiger und Einzelentwickler, die schnell loslegen möchten
Wechsel der PHP-Version	Manuell per brew link	Einfacher Wechsel per GUI
Lokale Domains	Manuelles Editieren von /etc/hosts	Automatische Einrichtung von .test-Domains
Dienstverwaltung	brew services	Starten/Stoppen per GUI
Anpassbarkeit	Hoch	Eingeschränkt

Wenn Sie Team- oder CI-Konfigurationen angleichen wollen oder häufig zwischen mehreren PHP-Versionen wechseln, ist der manuelle Aufbau mit Homebrew die passende Wahl.