Wie man das Laravel PHP Framework mit Apache 2 auf Ubuntu 22.04 installiert

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

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

Die Kombination des Laravel-Web-Frameworks mit einem anderen Framework wie React oder Vue ermöglicht es Ihnen, ein schönes und interaktives Frontend zu erstellen. Außerdem unterstützt es mehrere Datenbanken, darunter MySQL, PostgreSQL, SQLite und SQL Server. Laravel bietet auch eine Grundstruktur für sichere Authentifizierung.

In diesem Tutorial lernen Sie, wie Sie Laravel auf dem neuesten Ubuntu 22.04 LTS installieren. Dies umfasst auch die Einrichtung des LAMP-Stacks für die Laravel-Entwicklung.

Voraussetzungen

• Eine Ubuntu 22.04 Maschine. Dieses Beispiel verwendet den Ubuntu-Server.
• Ein Nicht-Root-Benutzer mit sudo-Administratorrechten oder Sie können auch den Root-Benutzer verwenden.

Installation des Apache Webservers

In diesem ersten Schritt installieren Sie den Apache2-Webserver auf Ihrem Ubuntu-System. In diesem Beispiel verwenden Sie das Laravel-Web-Framework mit dem Apache-Webserver.

Führen Sie nun den folgenden apt-Befehl aus, um Ihr Ubuntu-Repository zu aktualisieren und zu aktualisieren.

sudo apt update

Installieren Sie als Nächstes das Apache2-Webserver-Paket mit dem folgenden Befehl.

sudo apt install apache2

Geben Sie Y ein, um zu bestätigen, und drücken Sie ENTER, um die Installation zu starten. Die Installation des Apache-Webservers beginnt.

Nachdem die Apache2-Installation abgeschlossen ist, müssen Sie die HTTP- und HTTPS-Dienste zur UFW-Firewall hinzufügen.

Führen Sie den ufw-Befehl unten aus, um die HTTP- und HTTPS-Dienste zur UFW-Firewall hinzuzufügen.

sudo ufw allow "Apache Full"

Öffnen Sie schließlich Ihren Webbrowser und geben Sie die IP-Adresse des Servers in die Adresszeile ein (z. B. http://192.168.10.15). Jetzt sollten Sie die Standardseite index.html des Apache2-Webservers sehen.

Installation von PHP 8.1

Nach der Installation des Apache-Webservers installieren und konfigurieren Sie PHP auf der Ubuntu 22.04-Maschine. Das Standard-Ubuntu 22.04-Repository bietet das PHP-Paket v8.1, das gut für das Laravel-Web-Framework unterstützt wird.

Führen Sie den folgenden apt-Befehl aus, um die PHP-Pakete für das Laravel-Web-Framework zu installieren.

sudo apt install php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

Geben Sie Y ein, um die Installation zu bestätigen, und drücken Sie ENTER, um fortzufahren. Die PHP-Installation beginnt.

Nachdem die PHP-Installation abgeschlossen ist, bearbeiten Sie die Konfiguration php.ini mit dem Nano-Editor.

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

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

extension=fileinfo  
extension=mbstring  
extension=openssl

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind.

Starten Sie als Nächstes den Apache2-Dienst neu, um die neuen Änderungen an Ihrer PHP-Konfiguration anzuwenden.

sudo systemctl restart apache2

Überprüfen und testen Sie schließlich Ihre PHP-Konfiguration, indem Sie den folgenden Befehl ausführen.

Überprüfen Sie die auf Ihrer Ubuntu-Maschine installierte PHP-Version.

php --version

Im folgenden Screenshot sehen Sie, dass PHP 8.1.2 auf der Ubuntu-Maschine installiert ist.

Überprüfen Sie alle aktivierten Erweiterungen in Ihrer PHP-Umgebung.

php -m

Installation des MariaDB-Servers

Sie haben nun den Apache2-Webserver und die PHP-Pakete installiert. Jetzt installieren und konfigurieren Sie den MariaDB-Datenbankserver auf der Ubuntu 22.04-Maschine. Sie werden auch eine neue MariaDB-Datenbank und einen Benutzer für das Laravel-Projekt erstellen.

Um die MariaDB-Datenbank auf der Ubuntu-Maschine zu installieren, können Sie den folgenden apt-Befehl ausführen.

sudo apt install mariadb-server

Geben Sie Y ein, um zu bestätigen, und drücken Sie ENTER, um die Installation zu starten.

Nachdem die MariaDB-Installation abgeschlossen ist, melden Sie sich mit dem folgenden Befehl als Root-Benutzer bei der MariaDB-Shell an.

sudo mysql -u root -p

Führen Sie nun die folgenden MariaDB-Abfragen aus, um eine neue Datenbank und einen Benutzer für das Laravel-Projekt zu erstellen. In diesem Beispiel erstellen Sie die Datenbank laravelapp mit dem Benutzer laravel und dem Passwort password.

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

Führen Sie nun die Abfrage “EXIT“ aus, um sich von der MariaDB-Shell abzumelden. Sie haben nun den MariaDB-Datenbankserver installiert und eine neue Datenbank und einen Benutzer für das Laravel-Projekt erstellt.

Installation von Composer

In diesem Abschnitt installieren Sie Composer. Es ist ein Paketmanager für die Programmiersprache PHP, ähnlich wie pip in Python, das Gem in Ruby, npm oder Yarn für Node.js.

Das Laravel-Web-Framework kann auf viele Arten installiert werden. In diesem Beispiel installieren Sie das Laravel-Web-Framework mit Composer.

Führen Sie nun den folgenden Befehl aus, um den Installer für Composer herunterzuladen.

curl -sS https://getcomposer.org/installer -o composer-setup.php

Führen Sie nun das Installationsskript “composer-setup.php” aus, um Composer zu installieren. Dies installiert Composer im Verzeichnis /usr/local/bin.

php composer-setup.php --install-dir=/usr/local/bin --filename=composer

Unten ist der Screenshot der Composer-Installation.

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden Befehl aus, um die Installation von Composer zu überprüfen und zu bestätigen.

Überprüfen Sie die Version von Composer.

sudo -u www-data composer --version

Zeigen Sie die Hilfsinhalte von Composer an.

sudo -u www-data composer --help

Jetzt sind Sie bereit, mit der Installation von Laravel zu beginnen.

Beginnen Sie mit der Installation von Laravel

Bevor Sie mit der Installation von Laravel beginnen, erstellen wir neue Verzeichnisse für das Laravel-Projekt.

In diesem Beispiel erstellen Sie drei Verzeichnisse: “.cache” zum Speichern des Caches von PHP-Paketen, das Verzeichnis “.config” zum Speichern der zusätzlichen Konfiguration von Composer und das Verzeichnis “laravelapp” für das Laravel-Projekt selbst. Alle diese Verzeichnisse sind im Verzeichnis “/var/www“ verfügbar.

Führen Sie den folgenden Befehl aus, um neue Verzeichnisse für die Laravel-Installation zu erstellen.

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

Ändern Sie nun den Besitz der Laravel- und Composer-Verzeichnisse auf den Benutzer und die Gruppe www-data.

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

Wechseln Sie als Nächstes mit dem folgenden Befehl in das Verzeichnis /var/www/laravelapp.

cd /var/www/laravelapp/

Installieren Sie dann das Laravel-Web-Framework mit dem folgenden Composer-Befehl. Der Punkt am Ende des Befehls installiert Laravel im aktuellen Arbeitsverzeichnis /var/www/laravelapp.

sudo -u www-data composer create-project laravel/laravel .

Unten ist der Screenshot des Laravel-Installationsprozesses.

Und unten ist das Ergebnis, nachdem die Laravel-Installation abgeschlossen ist.

Nachdem die Installation abgeschlossen ist, bearbeiten Sie die Datei “.env” mit dem Nano-Editor. Diese Konfiguration ist die Hauptumgebungs-Konfiguration für Laravel, die die URL der Installation, die Datenbankdetails usw. enthält.

nano .env

Ändern Sie die APP_URL-Konfiguration mit Ihrer Domain für die Laravel-Installation. In diesem Beispiel wird Laravel unter dem Domainnamen laravelapp.howtoforge.local ausgeführt.

APP_URL=http://laravelapp.howtoforge.local

Ändern Sie nun die Datenbankdetails mit Ihrer Datenbankkonfiguration.

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

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind.

Sie haben nun die Installation des Laravel-Web-Frameworks mit dem MariaDB-Datenbankserver abgeschlossen.

Einrichtung des Apache Virtual Hosts

Jetzt ist es an der Zeit, den Apache2-Virtual Host für das Laravel-Web-Framework einzurichten. In diesem Beispiel wird das Laravel-Projekt unter der lokalen Domain laravelapp.howtoforge.local ausgeführt.

Erstellen Sie eine neue Datei “/etc/apache2/sites-available/laravel.conf“ mit dem Nano-Editor.

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

Fügen Sie die folgende Konfiguration in die Datei ein. Wenn Sie Ihren Domainnamen verwenden, können Sie die Domain ändern. Stellen Sie auch sicher, dass Sie den Pfad des Document Root für das Laravel-Projekt ändern.

  
    
    ServerAdmin [email protected]  
    ServerName laravelapp.howtoforge.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 schließen Sie sie, wenn Sie fertig sind.

Aktivieren Sie als Nächstes das Apache2-Modul rewrite und aktivieren Sie die Virtual Host-Konfiguration laravel.conf mit dem folgenden Befehl.

sudo a2enmod rewrite  
sudo a2ensite laravel.conf

Überprüfen Sie nun die Apache2-Konfiguration und stellen Sie sicher, dass keine Fehler vorliegen.

sudo apachectl configtest

Starten Sie nun den Apache2-Dienst neu, um die neue Virtual Host-Konfiguration für das Laravel-Projekt mit dem folgenden Befehl anzuwenden.

sudo systemctl restart apache2

Jetzt haben Sie die Apache-Virtual-Host-Konfiguration für Laravel abgeschlossen.

Bearbeiten Sie auf Ihrem Computer die Datei /etc/hosts mit dem Nano/Vim-Editor.

sudo nano /etc/hosts

Fügen Sie die folgende Konfiguration hinzu. Stellen Sie sicher, dass Sie den Domainnamen und die IP-Adresse mit Ihrem detaillierten Server ändern.

192.168.10.15 laravelapp.howtoforge.local

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind.

Gehen Sie schließlich zurück zu Ihrem Webbrowser und geben Sie die Laravel-Installations-URL (d. h. http://laravelapp.howtoforge.local) in die Adresszeile ein. Und Sie sollten die Standardindexseite des Laravel-Web-Frameworks sehen. Außerdem können Sie am unteren Rand die Laravel-Version sehen, die Sie gerade installiert haben, und die Version von PHP, die Sie derzeit verwenden.

Fazit

Herzlichen Glückwunsch! Sie haben jetzt erfolgreich das Laravel-Web-Framework auf Ubuntu 22.04 installiert. Sie haben auch die grundlegende Konfiguration des LAMP-Stacks für das Laravel-Web-Framework gelernt.