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

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

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

Version prüfen

php --version

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

(Optional) Eine bestimmte Version verwenden

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

brew install [email protected]

Wechseln Sie die Version mit brew link.

brew unlink php
brew link [email protected] --force --overwrite

Prüfen Sie die aktuell verknüpfte Version.

php --version

Composer installieren

Die Installation ist direkt über Homebrew möglich.

brew install composer

Version prüfen

composer --version

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.

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

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

Installation prüfen

nvm --version

Node.js installieren

LTS-Version installieren

nvm install --lts

Als Default setzen

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

nvm alias default node

Version prüfen

node --version
npm --version

Laravel-Installation prüfen

Laravel-Installer einrichten

composer global require laravel/installer

Neues Projekt anlegen

laravel new my-app

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

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.

Zuletzt geändert am 13. Juli 2026

Verwandte Themen