Laravel auf Uberspace installieren

Da ich mir das selbst mühselig zusammensuchen musste, hier mal eine vollständige Anleitung, um auf einem Uberspace-Hosting-Packet Laravel zum Laufen zu kriegen.

1. PHP Version

Zuerst muss man überprüfen, welche PHP-Version auf Uberspace gerade eingestellt ist, denn Laravel benötigt mindesten 5.5.9:

php -v

Falls hierbei eine kleiner Versionsnummer rauskommt, als 5.5.9, kann man diese ganz einfach ändern. Wie kann man am besten im Uberspace-Wiki nachlesen: PHP Version einstellen...

2. Composer installieren

Als nächstes müssen wir Composer installieren. Hierbei handel es sich um einen Packet-Manager für PHP, über den sich bequem Abhängigkeiten von PHP Projekten installieren und pflegen lassen. Composer brauchen wir jetzt aber in erster Linie, um Laravel darüber bequemer zu installieren.

Mit folgendem Befehl holen wir uns das Composer-Packet über curl und schieben es direkt ins /bin Verzeichnis als composer Datei, damit wir es in Zukunft von jedem beliebigen Ordner über composer ausführen können:

curl -sS <a href="https://getcomposer.org/installer">https://getcomposer.org/installer</a> | php -- --filename=composer --install-dir=$HOME/bin

Die Ausgabe sollte wie folgt aussehen:

All settings correct for using Composer
Downloading...

Composer successfully installed to: /home/username/bin/composer
Use it: php /home/username/bin/composer

Die erfolgreiche Installation lässt sich testen mit dem Aufruf:

composer about

Und hier sollten die About-Information von Composer erscheinen:

Composer - Package Management for PHP
Composer is a dependency manager tracking local dependencies of your projects and libraries.
See https://getcomposer.org/ for more information.

Mehr Infos zu Composer unter http://getcomposer.org.

3. Laravel installieren

Jetzt aber endlich zum Hauptthema dieses Blogartikels: Die Laravel Installation.

Dank Composer haben wir es jetzt hier sehr leicht:

composer global require "laravel/installer"

Nachdem das abgeschlossen wurde, müssen wir nun ähnlich wie bei Composer, noch das ganze in der CLI bekannt machen, damit wir auch hier das Schlüsselwort laravel zum bequemen Ausführen überall parat haben.

Dafür müssen wir den Pfad zu Laravel in der .bashrc Datei hinzufügen:

echo 'export PATH="$PATH:$HOME/.composer/vendor/bin"' >> ~/.bashrc

Und mit

source ~/.bashrc

aktualisieren wir das für die aktuelle CLI-Sitzung.

Nun sollte man in einem beliebigen Ordner über

laravel

die Version und Hilfe vom Laravel Installer angezeigt bekommen.

Somit haben wir nun in jedem beliebigen Ordner auf Uberspace die Möglichkeit mit

laravel new

ein neues Laravel-Projekt zu initialisieren. Mehr Infos zu Laravel unter https://laravel.com/docs/.

Viel Spaß mit Laravel 😉

Im nächsten Blogartikel geh ich darauf ein, wie eine Ordnerstruktur für ein Laravel-Projekt auf Uberspace ausschauen kann, sodass man auch im Public-Verzeichnis von Laravel landet.