Installiere zuerst den Installer mit composer global require laravel/installer und frage Composer dann, wo es seine Programme ablegt: composer global config bin-dir --absolute. Nimm diesen Pfad in deinen PATH in ~/.zshrc auf und führe danach source ~/.zshrc aus. Unter macOS mit bash ist die Datei ~/.bash_profile, niemals ~/.bashrc.
Du tippst laravel new mein-projekt und das Terminal antwortet:
zsh: command not found: laravelDas Problem ist fast nie Laravel. Die von Composer installierte ausführbare Datei liegt in einem Ordner, in den deine Shell nie schaut. Du musst diesen Ordner also finden und ihn dann in den PATH aufnehmen.
Artikel aus dem Lernpfad Webentwicklung. Vorgehen am 2. September 2026 unter macOS 26.5.1 mit Composer 2.9.5 und zsh geprüft.
Zuerst: Ist der Installer überhaupt installiert?
Der Befehl laravel kommt nicht mit Composer mit, er wird getrennt installiert:
composer global require laravel/installerWenn du das nie ausgeführt hast, bringt keine noch so gute PATH-Einstellung den Befehl zum Vorschein. Und du kommst problemlos ohne ihn aus: composer create-project laravel/laravel mein-projekt erledigt dasselbe ganz ohne globalen Installer.
Den richtigen Ordner finden, statt ihn zu raten
In den meisten Tutorials sollst du $HOME/.composer/vendor/bin übernehmen. Das stimmt oft, aber nicht immer: Composer wählt sein Heimatverzeichnis je nach System und vorhandenen Umgebungsvariablen. Statt darauf zu wetten, frag es einfach:
composer global config bin-dir --absolute/Users/gekkode/.composer/vendor/binDas ist das Ergebnis unter macOS 26.5.1. Auf einer Installation, die den XDG-Konventionen folgt, kann der Befehl ~/.config/composer/vendor/bin zurückgeben. Nimm immer das, was der Befehl bei dir ausgibt, und nicht das, was ein Tutorial behauptet.
Solange kein globales Paket installiert ist, stimmt der Pfad zwar, der Ordner fehlt aber. Das ist folgenlos: Ein nicht existierender Ordner im PATH löst keinen Fehler aus, und beim ersten composer global require wird er angelegt.
Den Ordner mit zsh in den PATH aufnehmen
zsh ist seit Catalina die Standard-Shell von macOS. Zu bearbeiten ist die Datei ~/.zshrc:
echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcErsetze den Pfad durch den, den der vorherige Befehl zurückgegeben hat. Das source wendet die Änderung auf die laufende Sitzung an, ohne es greift sie erst in einem neuen Terminal.
Zur Kontrolle:
which laravel
laravel --versionUnd wenn du bash benutzt
Unter macOS Mojave und älter, oder wenn du bewusst bei bash geblieben bist, ist die Datei ~/.bash_profile:
echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profileDas ist der klassische Fehler, und die vorherige Fassung dieses Artikels hat ihn gemacht. Unter macOS öffnet das Terminal eine Login-Shell, die ~/.bash_profile liest und nicht ~/.bashrc. Eine Zeile in ~/.bashrc wird nie angewendet, was den Eindruck erweckt, die ganze Sache funktioniere nicht.
Um herauszufinden, welche Shell läuft:
echo $SHELL
# /bin/zsh → ~/.zshrc
# /bin/bash → ~/.bash_profileWenn der Befehl weiterhin nicht gefunden wird
Drei Prüfungen, der Reihe nach. Zuerst: Enthält der PATH den Ordner wirklich?
echo $PATH | tr ':' '\n' | grep composerDann: Ist die ausführbare Datei vorhanden?
ls "$(composer global config bin-dir --absolute)"Fehlt sie, ist die globale Installation gescheitert. Starte sie erneut und lies die Ausgabe: Ein Konflikt bei der PHP-Version ist die häufigste Ursache.
Und schließlich: Wird Composer selbst nicht gefunden, ist es dasselbe Problem eine Ebene tiefer. Unter macOS ist die Installation über Homebrew am einfachsten:
brew install composerAuf einem Server stellt sich die Frage anders: siehe Composer unter Debian installieren.
Die Alternative, die das Problem beseitigt
Laravel Herd installiert PHP, Composer und den Laravel-Installer in einer verwalteten Umgebung und kümmert sich selbst um den PATH. Für einen von Grund auf neu aufgesetzten macOS-Entwicklungsrechner ist das der kürzeste Weg: Es bleibt keine Shell-Konfigurationsdatei mehr anzufassen.
Wenn du bereits mit einer Homebrew-Installation arbeitest, die du im Griff hast, bleibt der oben beschriebene Weg über den PATH vollkommen gültig.
Häufige Fehler
~/.bash_profile liest. Eine Zeile in ~/.bashrc wird nie angewendet.composer global config bin-dir --absolute liefert den richtigen Pfad auf deinem Rechner.source auf der geänderten Datei aus.
