Laravel installieren unter Ubuntu und macOS

von
Peter Homburg
Letzte Artikel von Peter Homburg (Alle anzeigen)

Laravel ist eines der beliebtesten PHP-Frameworks für moderne Webanwendungen. In diesem Artikel zeigen wir praxisnah, wie Sie Laravel auf Ubuntu 18.04 (mit PHP 7.3 als Beispiel) und macOS installieren. Zusätzlich erhalten Sie Tipps für die Einrichtung, Fehlerbehandlung und weiterführende Ressourcen.

Voraussetzungen prüfen

Bevor Sie Laravel installieren, vergewissern Sie sich, dass Ihre Umgebung komplett vorbereitet ist.

Beispielumgebung

  • Betriebssystem: Ubuntu 18.04 LTS
  • PHP-Version: 7.3 (mindestens PHP 7.3, für Laravel 10 wird PHP ≥ 8.1 empfohlen)
  • Webserver: Apache oder Nginx
  • Datenbank: MariaDB oder MySQL
  • Paketmanager: Composer (erforderlich)

Überprüfen Sie Ihre Versionen

bashphp -v
composer --version
php -m

Achten Sie darauf, dass die wichtigsten PHP-Extensions wie mbstring, pdo, tokenizer, xml, ctype und openssl installiert sind. Falls etwas fehlt, installieren Sie die Pakete. Beispiel für Ubuntu:

bashsudo apt install php7.3-mbstring php7.3-xml php7.3-mysql
sudo systemctl restart apache2

Schritt 1: Composer installieren

Wenn Composer noch nicht verfügbar ist, installieren Sie ihn manuell:

bashphp -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
sudo mv composer.phar /usr/local/bin/composer

Testen Sie anschließend die Installation:

bashcomposer --version

Schritt 2: Laravel Installer global installieren

Mit Composer können Sie den Laravel Installer global verfügbar machen:

bashcomposer global require laravel/installer

Composer-Bin-Verzeichnis in den PATH einfügen

Damit der laravel-Befehl systemweit genutzt werden kann, ergänzen Sie den PATH.

  • Composer v1 (macOS/Linux):bashexport PATH="$HOME/.composer/vendor/bin:$PATH"
  • Composer v2 (Linux):bashexport PATH="$HOME/.config/composer/vendor/bin:$PATH"

Tragen Sie diesen Eintrag in Ihre ~/.bashrc oder ~/.zshrc ein, um die Änderung dauerhaft zu speichern.

Schritt 3: Neues Laravel-Projekt erstellen

Es gibt zwei gängige Methoden:

Mit dem Laravel Installer

bashlaravel new projektname

Mit Composer create-project

bashcomposer create-project --prefer-dist laravel/laravel projektname

Anschließend wechseln Sie ins Projektverzeichnis und starten den lokalen Entwicklungsserver:

bashcd projektname
php artisan serve

Rufen Sie nun http://localhost:8000 im Browser auf.

Troubleshooting

Häufige Fehler und Lösungen

  • Fehler: composer: command not found
    Lösung: Composer installieren und sicherstellen, dass /usr/local/bin im PATH liegt.
  • Fehler: laravel: command not found
    Lösung: Prüfen Sie, ob das Composer-Bin-Verzeichnis in den PATH aufgenommen wurde.
  • Berechtigungsprobleme bei composer global require
    Lösung: Vermeiden Sie sudo. Setzen Sie stattdessen:bashcomposer config --global home $HOME/.config/composer
  • Fehlende PHP-Extension
    Lösung (Beispiel für mbstring):bashsudo apt install php7.3-mbstring sudo systemctl restart apache2

Fazit

Mit wenigen Schritten können Sie Laravel auf Ubuntu oder macOS einrichten. Wichtig ist die korrekte Composer-Installation und die Konfiguration Ihres PATH. Dank der robusten CLI-Tools von Laravel gelingt die Einrichtung unkompliziert – typische Fehler lassen sich mit den Tipps in diesem Artikel schnell beheben.