So installieren Sie das Laravel PHP-Framework auf Ubuntu 24.04

Laravel ist ein Webanwendungs-Framework, das auf PHP basiert und zum Erstellen von Unternehmens-Webanwendungen verwendet wird. Es ist ein kostenloses und offenes Web-Framework, das die Architektur Model-View-Controller (MVC) verfolgt und auf Symfony basiert. Es bietet eine elegante Syntax, die es Ihnen ermöglicht, Anwendungen mit sauberem Code zu erstellen, die leicht zu lesen und zu verstehen sind.

Laravel ist ein Unternehmens-Framework zum Erstellen robuster Full-Stack-Webanwendungen. Laravel-Anwendungen können schnell ohne Kopfschmerzen vom Entwicklungsprozess bis zur Produktion bereitgestellt werden.

Dieser Leitfaden zeigt Ihnen, wie Sie das Laravel-Web-Framework auf dem Ubuntu 24.04-Server installieren. Sie installieren Laravel mit dem LAMP-Stack (Linux, Apache, MySQL/MariaDB und PHP) und dem Composer PHP-Paketmanager.

Voraussetzungen

Bevor Sie mit diesem Leitfaden beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Einen Ubuntu 24.04-Server.
• Einen Nicht-Root-Benutzer mit Administratorrechten

Installation des LAMP-Stacks und von Composer

Laravel ist ein beliebtes PHP-Web-Framework für die moderne Webentwicklung. Daher müssen Sie sicherstellen, dass PHP und andere Abhängigkeiten auf Ihrem Ubuntu-Server installiert sind. In diesem Abschnitt installieren Sie Laravel mit dem LAMP-Stack (Linux, Apache, MySQL/MariaDB und PHP) und Composer.

Bevor Sie das Paket installieren, führen Sie den folgenden Befehl aus, um Ihr Ubuntu-Repository zu aktualisieren.

sudo apt update

Führen Sie jetzt den folgenden Befehl aus, um die Abhängigkeiten von Laravel zu installieren, einschließlich des LAMP-Stacks (Linux, Apache, MySQL/MariaDB und PHP), Composer und Git.

sudo apt install apache2 mariadb-server php php-curl php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip composer git

Geben Sie Y ein, um mit der Installation fortzufahren.

Sobald die Installation abgeschlossen ist, überprüfen Sie den Status der Dienste von Apache und MariaDB. Überprüfen Sie dann die Versionen von PHP und Composer.

Überprüfen Sie den Status des Apache-Dienstes mit dem folgenden Befehl. Der Standard-Apache-Dienst auf Ubuntu sollte automatisch aktiviert und ausgeführt werden.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Ausgabe:

Überprüfen Sie nun den MariaDB-Dienst mit dem folgenden Befehl. Der MariaDB-Server sollte auf Ihrem Ubuntu-System aktiviert und ausgeführt werden.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Ausgabe:

Überprüfen Sie schließlich die PHP- und Composer-Versionen mit dem folgenden Befehl. Sie sollten PHP 8.3 und Composer 2.7.1 auf Ihrem System installiert sehen.

php -v  
sudo -u www-data composer -v

Optional: Installation von Node.js und NPM (Node.js-Paketmanager)

Node.js und NPM sind erforderlich, wenn Sie Laravel mit einer Template-Engine wie Blade und JavaScript verwenden. In diesem Abschnitt installieren Sie sowohl Node.js als auch NPM (Node.js-Paketmanager) über das Ubuntu-Repository.

Um Node.js und NPM auf Ihrem Ubuntu-System zu installieren, führen Sie Folgendes aus:

sudo apt install nodejs npm

Geben Sie Y ein, um die Installation zu bestätigen.

Wenn die Installation abgeschlossen ist, geben Sie den folgenden Befehl ein, um die Version von Node.js und NPM zu überprüfen.

node --version  
npm --version

Die folgende Ausgabe zeigt, dass Node.js 18 und NPM 9.5 installiert sind.

Konfigurieren von PHP

Um Laravel auszuführen, müssen Sie sicherstellen, dass einige PHP-Erweiterungen aktiviert sind, wie fileinfo, mbstring und openssl. Laden Sie jetzt diese PHP-Erweiterungen, indem Sie die Datei ‘php.ini’ ändern.

Verwenden Sie den Nano-Editor, um die Standard-PHP-Konfigurationsdatei ‘/etc/php/8.3/apache2/php.ini’ zu bearbeiten.

sudo nano /etc/php/8.3/apache2/php.ini

Kommentieren Sie die folgenden Zeilen aus, um die PHP-Erweiterungen fileinfo, mbstring und openssl zu aktivieren.

extension=fileinfo  
extension=mbstring  
extension=openssl

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie jetzt den folgenden Befehl aus, um den Apache-Dienst neu zu starten und die Änderungen an PHP anzuwenden.

sudo systemctl restart apache2

Überprüfen Sie als Nächstes die PHP-Erweiterungen fileinfo, mbstring und openssl mit dem folgenden Befehl. Wenn diese Erweiterungen aktiviert sind, wird jeder Erweiterungsname angezeigt.

sudo php -m | grep 'fileinfo\|mbstring\|openssl'

Zusätzlich können Sie die Liste der aktivierten PHP-Erweiterungen über PHPINFO überprüfen. Erstellen Sie eine neue PHPINFO-Datei mit dem folgenden Befehl.

echo "" > /var/www/html/info.php

Besuchen Sie dann http://192.168.5.30/info.php. Überprüfen Sie die Erweiterungen fileinfo, mbstring und openssl, um sicherzustellen, dass diese Erweiterungen aktiviert sind.

Konfigurieren des MariaDB-Servers

Nachdem Sie PHP konfiguriert haben, müssen Sie Ihren MariaDB-Server sichern und eine neue Datenbank und einen neuen Benutzer für Laravel erstellen.

Führen Sie den Befehl ‘mariadb-secure-installation’ unten aus, um Ihren MariaDB-Server zu sichern. Jetzt werden Sie mit den Konfigurationen des MariaDB-Servers aufgefordert.

sudo mariadb-secure-installation

Wenn Sie dazu aufgefordert werden, geben Sie Y ein, um die neue Konfiguration anzuwenden, oder N, um sie abzulehnen.

• Die Standardinstallation von MariaDB kommt ohne Passwort. Drücken Sie ENTER, wenn Sie nach dem Passwort gefragt werden.
• Geben Sie jetzt Y ein, um das MariaDB-Root-Passwort festzulegen. Geben Sie dann das neue Passwort für MariaDB ein und wiederholen Sie das Passwort.
• Geben Sie Y ein, um den anonymen Benutzer aus Ihrer MariaDB-Installation zu entfernen.
• Geben Sie erneut Y ein, wenn Sie dazu aufgefordert werden, die Remote-Anmeldung für den MariaDB-Root-Benutzer zu deaktivieren.
• Geben Sie Y ein, um die Standarddatenbank test aus Ihrer MariaDB zu entfernen.
• Geben Sie schließlich Y ein, um die Tabellenberechtigungen neu zu laden und die neuen Änderungen anzuwenden.

Nachdem Sie den MariaDB-Server gesichert haben, müssen Sie eine neue Datenbank und einen neuen Benutzer für Ihr Laravel-Projekt erstellen.

Melden Sie sich mit dem folgenden Befehl beim MariaDB-Server an. Geben Sie Ihr MariaDB-Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie nun die folgenden Abfragen aus, um eine neue Datenbank und einen Benutzer ‘laravelapp‘ mit dem Passwort ‘password‘ zu erstellen.

CREATE DATABASE laravelapp;  
CREATE USER laravelapp@localhost IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON laravelapp.* TO laravelapp@localhost;  
FLUSH PRIVILEGES;

Führen Sie als Nächstes die folgende Abfrage aus, um die Berechtigungen für den Benutzer ‘laravelapp‘ zu überprüfen. Dies stellt sicher, dass Ihr Benutzer auf die Laravel-Datenbank ‘laravelapp‘ zugreifen kann.

SHOW GRANTS FOR laravelapp@localhost;

Geben Sie schließlich quit ein, um den MariaDB-Server zu verlassen.

Installation von Laravel über Composer

Jetzt, da Sie PHP konfiguriert und eine MySQL/MariaDB-Datenbank und einen Benutzer erstellt haben, können Sie Laravel installieren. In diesem Abschnitt richten Sie das Projektverzeichnis ein, installieren Laravel über Composer und integrieren Laravel mit der MySQL/MariaDB-Datenbank.

Zuerst führen Sie den folgenden Befehl aus, um die Verzeichnisse /var/www/.cache (für den Composer-Cache), /var/www/.config (für zusätzliche Composer-Konfiguration) und /var/www/laravelapp (für Ihr Laravel-Projekt) zu erstellen.

sudo mkdir -p /var/www/{.cache,.config,laravelapp}

Ändern Sie jetzt den Besitz der Verzeichnisse /var/www/.cache, /var/www/.config und /var/www/laravelapp auf den Benutzer ‘www-data‘.

sudo chown -R www-data:www-data /var/www/{.cache,.config,laravelapp}

Gehen Sie als Nächstes in das Verzeichnis /var/www/laravelapp und installieren Sie Laravel mit dem folgenden Composer-Befehl.

cd /var/www/laravelapp/  
sudo -u www-data composer create-project laravel/laravel .

Die Laravel-Installation sollte wie folgt beginnen:

Öffnen Sie jetzt die ‘.env’-Datei mit dem folgenden Befehl im Nano-Editor.

nano .env

Ändern Sie die Standard- ‘APP_URL‘ mit Ihrem lokalen Domänennamen. In diesem Beispiel wird Laravel unter der Domain ‘laravelapp.local’ ausgeführt.

APP_URL=http://laravelapp.local

Ändern Sie die Standard- ‘DB_CONNECTION‘ in ‘mysql‘, kommentieren Sie aus und ändern Sie die Datenbankdetails mit Ihren Informationen.

DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravelapp  
DB_PASSWORD=password

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie schließlich den folgenden Befehl aus, um die Datenbank für Ihr Laravel-Projekt zu migrieren.

sudo -u www-data php artisan migrate

Ausgabe der Laravel-Datenbankmigration:

Einrichten eines virtuellen Hosts für Laravel

In diesem Abschnitt richten Sie die virtuelle Host-Datei für Laravel ein. Stellen Sie sicher, dass Sie den lokalen Domänennamen für Ihre Laravel-Entwicklung bereit haben.

Bevor Sie einen virtuellen Host erstellen, aktivieren Sie das Apache-rewrite-Modul mit dem folgenden Befehl.

sudo a2enmod rewrite

Erstellen Sie eine neue virtuelle Host-Konfiguration ‘/etc/apache2/sites-available/laravelapp.conf‘ mit dem Nano-Editor.

sudo nano /etc/apache2/sites-available/laravelapp.conf

Fügen Sie die folgende Konfiguration hinzu und ändern Sie die ServerName-Option mit Ihrem Laravel-Domänennamen, z. B. ‘laravelapp.local‘.

  
  
  ServerAdmin [email protected]  
  ServerName laravelapp.local  
  DocumentRoot /var/www/laravelapp/public  
  
    
    Options FollowSymLinks  
    AllowOverride None  
    
    
    AllowOverride All  
    
  
  ErrorLog ${APACHE_LOG_DIR}/error.log  
  CustomLog ${APACHE_LOG_DIR}/access.log combined  
  

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie jetzt den folgenden Befehl aus, um den virtuellen Host ‘laravelapp.conf‘ zu aktivieren und Ihre Apache-Syntax zu überprüfen. Wenn kein Fehler auftritt, sollten Sie die Ausgabe ‘Syntax OK‘ sehen.

sudo a2ensite laravelapp.conf  
sudo apachectl configtest

Starten Sie den Apache-Dienst neu, um die neue Laravel-Virtual-Host-Datei anzuwenden. Nachdem Apache neu gestartet wurde, ist Ihre Laravel-Installation bereit.

sudo systemctl restart apache2

Zugriff auf das Laravel-Projekt

An diesem Punkt sind Sie bereit, auf Ihre Laravel-Installation über die ‘hosts’-Datei zuzugreifen.

Für Linux- oder MacOS-Benutzer ändern Sie die ‘/etc/hosts‘-Datei mit Root-Rechten. Für Windows-Benutzer öffnen Sie die Datei ‘C:\Windows\System32\drivers\etc\hosts‘ als Administrator.

Fügen Sie die IP-Adresse Ihres Ubuntu-Servers gefolgt vom Laravel-Domänennamen wie folgt hinzu:

192.168.5.30 laravelapp.local

Speichern Sie die Datei und beenden Sie sie.

Besuchen Sie nun http://laravelapp.local/ mit Ihrem Webbrowser. Wenn Ihre Laravel-Installation erfolgreich ist, sollten Sie die folgende Seite erhalten:

Fazit

Herzlichen Glückwunsch! Sie haben die Laravel-Installation auf Ubuntu 24.04 abgeschlossen. Sie haben Laravel mit dem LAMP-Stack (Linux, Apache, MySQL/MariaDB und PHP) zum Laufen gebracht und die grundlegenden Composer-Befehle zum Erstellen eines Projekts gelernt.