Wie man Laravel auf Debian 12 installiert

Laravel ist ein Webanwendungs-Framework, das auf PHP basiert und für den Aufbau 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, der leicht zu lesen und zu verstehen ist.

Laravel ist ein Unternehmens-Framework für den Aufbau robuster Full-Stack-Webanwendungen. Laravel-Anwendungen können schnell und ohne Kopfschmerzen von der Entwicklungsphase 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 ein Gerüst für sichere Authentifizierung.

In diesem Leitfaden zeigen wir Ihnen Schritt für Schritt, wie Sie Laravel auf Debian 12 installieren, damit Sie mit dem Laravel-Projekt beginnen können. Wir zeigen Ihnen, wie Sie Laravel mit dem Apache2-Webserver, MariaDB und PHP 8.2 installieren.

Voraussetzungen

Im Folgenden sind die Anforderungen aufgeführt, die Sie befolgen müssen, um diesem Leitfaden zu folgen:

• Ein Debian 12-Server.
• Ein Nicht-Root-Benutzer mit Administratorrechten.

Installation des LAMP-Stacks

Der erste Schritt, den Sie unternehmen müssen, ist die Installation des LAMP-Stacks (Apache2, MariaDB und PHP) auf Ihrem Debian-Server. Dann werden Sie auch die Dienste von Apache2 und MariaDB überprüfen, um sicherzustellen, dass der Dienst läuft.

Bevor Sie Pakete installieren, führen Sie den Befehl apt update aus, um die Debian-Repositories zu aktualisieren und zu aktualisieren.

sudo apt update

Sobald das Repository aktualisiert ist, installieren Sie die Pakete des LAMP-Stacks (Apache2, PHP und MariaDB), indem Sie den folgenden Befehl apt install ausführen. Der folgende Befehl installiert auch einige der PHP-Erweiterungen, die von Laravel benötigt werden.

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

Geben Sie y ein, um die Installation zu bestätigen und fortzufahren.

Nachdem der LAMP-Stack installiert ist, führen Sie den folgenden systemctl-Befehl aus, um die Dienste von apache2 und mariadb zu überprüfen. Wenn der Dienst läuft, sollten Sie die Ausgabe active (running) erhalten.

sudo systemctl status apache2  
sudo systemctl status mariadb

Für den Apache2-Dienst sollten Sie eine Ausgabe wie diese erhalten:

Und hier ist der Status des MariaDB-Dienstes.

Führen Sie als Nächstes den PHP-Befehl aus, um die PHP-Version und die aktivierten Module zu überprüfen. Sie sollten PHP 8.2 installiert sehen, mit einigen aktivierten Modulen wie curl, date, dom und exif.

php -v  
php -m

Starten Sie schließlich Ihren Webbrowser und besuchen Sie die IP-Adresse Ihres Debian-Servers (z. B.: http://192.168.10.15/). Wenn die Installation erfolgreich war, sollten Sie die index.html-Seite des Apache-Webservers erhalten.

Konfigurieren von PHP

Um Laravel zu installieren, müssen einige PHP-Erweiterungen aktiviert werden, wie fileinfo, mbstring und openssl. Sie können diese Erweiterungen über die php.ini-Datei aktivieren.

Verwenden Sie den folgenden Befehl des Nano-Editors, um die PHP-Konfigurationsdatei /etc/php/8.2/apache2/php.ini zu öffnen.

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

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

extension=fileinfo  
extension=mbstring  
extension=openssl

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie als Nächstes den folgenden systemctl-Befehl aus, um den Apache2-Dienst neu zu starten und die Änderungen anzuwenden.

sudo systemctl restart apache2

Stellen Sie dann sicher, dass die PHP-Erweiterungen fileinfo, mbstring und openssl aktiviert sind, indem Sie den folgenden PHP-Befehl ausführen.

sudo php -m

Erstellen Sie jetzt eine neue phpinfo-Datei /var/www/html/info.php mit dem folgenden Befehl. Wenn Ihre Installation von PHP und dem Apache2-Webserver erfolgreich ist, zeigt dies Ihnen detaillierte Informationen über Ihre PHP-Installation an.

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

Öffnen Sie Ihren bevorzugten Webbrowser und besuchen Sie die Server-IP-Adresse, gefolgt vom Pfad zur Datei info.php (z. B.: http://192.168.10.15/info.php). Wenn es erfolgreich ist, sollten Sie eine Ausgabe wie diese sehen:

Konfigurieren des MariaDB-Servers

Nachdem Sie PHP konfiguriert haben, konfigurieren Sie Ihren MariaDB-Server, was die Sicherung des MariaDB-Servers über das Dienstprogramm mariadb-secure-installation umfasst, und dann das Erstellen einer neuen Datenbank und eines Benutzers für Ihr Laravel-Projekt.

Führen Sie zunächst den folgenden Befehl mariadb-secure-installation aus, um Ihre MariaDB-Serverinstallation zu sichern. Während des Prozesses werden Sie nach einigen MariaDB-Konfigurationen gefragt, geben Sie Y ein, um die Konfiguration zu bestätigen, oder n für Nein.

sudo mariadb-secure-installation

Im Folgenden sind einige der MariaDB-Einstellungen aufgeführt, nach denen Sie während des Prozesses gefragt werden:

• Drücken Sie ENTER, wenn Sie nach dem MariaDB-Root-Passwort gefragt werden.
• Geben Sie n ein, wenn Sie nach der Authentifizierungsmethode unix_socket gefragt werden.
• Geben Sie Y ein, um ein neues Passwort für den MariaDB-Root-Benutzer festzulegen. Geben Sie dann das neue Passwort ein und wiederholen Sie es.
• Geben Sie Y ein, um den standardmäßigen anonymen Benutzer von MariaDB zu entfernen.
• Geben Sie dann erneut Y ein, um die Remote-Anmeldung für den MariaDB-Root-Benutzer zu deaktivieren.
• Geben Sie Y ein, um die Standarddatenbank test von MariaDB zu entfernen.
• Geben Sie schließlich erneut Y ein, um die Tabellenberechtigungen neu zu laden und die Änderungen anzuwenden.

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

Melden Sie sich über den folgenden Befehl mariadb am MariaDB-Server an. Geben Sie Ihr MariaDB-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie nun die folgenden Abfragen aus, um eine neue Datenbank testapp, den Benutzer testapp und das Passwort password zu erstellen. Stellen Sie sicher, dass Sie das Passwort in der folgenden Abfrage ändern.

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

Führen Sie als Nächstes die folgende Abfrage aus, um sicherzustellen, dass der Benutzer testapp auf die Datenbank testapp zugreifen kann.

SHOW GRANTS FOR testapp@localhost;

Die folgende Ausgabe bestätigt, dass der Benutzer testapp auf die Datenbank testapp zugreifen kann.

Geben Sie schließlich quit ein, um den MariaDB-Server zu verlassen und diesen Schritt abzuschließen.

Installation von Composer

Laravel kann auf viele Arten installiert werden, und die einfachste Möglichkeit besteht darin, es über Composer, den PHP-Paketmanager, zu installieren. Jetzt werden Sie Composer auf Ihrem Debian-Server installieren.

Um den Composer PHP-Paketmanager zu installieren, führen Sie den folgenden Befehl apt install aus. Geben Sie y ein, wenn Sie zur Fortsetzung der Installation aufgefordert werden.

sudo apt install composer

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden Befehl aus, um die Binärdatei von Composer zu finden und die Composer-Version zu überprüfen.

which composer  
sudo -u www-data composer --version

Die Binärdatei von Composer befindet sich unter /usr/bin/composer und Composer 2.5.5 ist installiert.

Erstellen des ersten Laravel-Projekts

Mit allem an seinem Platz sind Sie bereit, das erste Laravel-Projekt zu installieren und zu erstellen. Sie werden das erste Laravel-Projekt mit MariaDB als Datenbank erstellen.

Zuerst erstellen Sie ein neues Dokumentenstammverzeichnis /var/www/testapp für Ihr Projekt und ändern den Besitz auf den Benutzer www-data über den folgenden Befehl. Sie erstellen auch die Verzeichnisse /var/www/.cache und /var/www/.config, die von Composer verwendet werden.

sudo mkdir -p /var/www/{.cache,.config,testapp}  
sudo chown -R www-data:www-data /var/www/{.cache,.config,testapp}

Wechseln Sie jetzt in das Verzeichnis /var/www/testapp/ und führen Sie den folgenden Composer-Befehl aus, um das erste Laravel-Projekt zu erstellen. Ihr erstes Laravel-Projekt wird im Verzeichnis /var/www/testapp/ gespeichert.

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

Während der Installation sollten Sie eine ähnliche Ausgabe wie diese erhalten:

Mit dem erstellten Laravel-Projekt werden Sie als Nächstes die Datenbank für Ihr Projekt über die .env-Konfigurationsdatei einrichten. Die .env-Datei wird als Basis-Konfiguration für Ihr Laravel-Projekt verwendet.

Verwenden Sie den folgenden Befehl des Nano-Editors, um die .env-Datei zu öffnen.

nano .env

Ändern Sie den Parameter APP_URL mit dem lokalen Domänennamen Ihres Laravel-Projekts. Auf diese Weise können Sie auf Ihr Projekt über einen lokalen Domänennamen zugreifen. In diesem Fall ist der Domänenname testapp.local.

APP_URL=http://testapp.local

Ändern Sie jetzt die Datenbankkonfiguration DB_CONNECTION in mysql und ändern Sie die Details von DB_DATABASE, DB_USERNAME und DB_PASSWORD mit Ihren MariaDB-Datenbank- und Benutzerinformationen.

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

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie jetzt den folgenden Befehl aus, um die Datenbank zu migrieren. Dies wird Tabellen für das Laravel-Projekt erstellen.

sudo -u www-data php artisan migrate

Konfigurieren des Apache-Virtual Hosts

Im nächsten Schritt erstellen Sie eine neue Apache2-Virtual-Host-Konfiguration für Ihr Laravel-Projekt. Danach müssen Sie den Virtual Host aktivieren und die Apache2-Konfigurationen überprüfen, bevor Sie den Apache2-Webserver neu starten, um die Änderungen wirksam werden zu lassen.

Bevor Sie die Apache2-Virtual-Host-Konfiguration für Laravel erstellen, müssen Sie das rewrite-Modul in Apache2 über den folgenden Befehl aktivieren.

sudo a2enmod rewrite

Verwenden Sie den folgenden Befehl des Nano-Editors, um die Apache2-Virtual-Host-Konfiguration /etc/apache2/sites-available/laravel.conf zu erstellen.

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

Fügen Sie die folgende Konfiguration ein und ändern Sie den Parameter ServerName mit Ihrem Domänennamen.

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

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie als Nächstes den folgenden Befehl aus, um die Virtual-Host-Konfiguration laravel.conf zu aktivieren und die Apache2-Konfigurationen zu überprüfen. Wenn Sie die richtigen Konfigurationen haben, sollten Sie eine Nachricht wie Syntax OK erhalten.

sudo a2ensite laravel.conf  
sudo apachectl configtest

Starten Sie schließlich den Apache2-Dienst, indem Sie den folgenden Befehl ausführen und die Änderungen anwenden, die Sie vorgenommen haben.

sudo systemctl restart apache2

Zugriff auf Laravel

Wenn Sie sich auf einem Linux-Client befinden, ändern Sie die Datei /etc/hosts über den folgenden Befehl des Nano-Editors.

sudo nano /etc/hosts

Wenn Sie sich auf einem Windows-Rechner befinden, ändern Sie die Datei C:\Windows\System32\drivers\etc\hosts.

Fügen Sie den Domänennamen Ihres Laravel-Projekts und die IP-Adresse Ihres Debian-Servers wie folgt ein:

192.168.10.15   testapp.local

Speichern Sie die Datei und beenden Sie den Editor.

Starten Sie schließlich Ihren Webbrowser und besuchen Sie den lokalen Domänennamen Ihres Laravel-Projekts (z. B.: http://testapp.local). Wenn es erfolgreich ist, sollten Sie eine ähnliche Seite von Laravel wie diese erhalten:

Fazit

Zusammenfassend haben Sie Laravel mit dem LAMP-Stack (Apache2, MariaDB und PHP) auf dem Debian 12-Server installiert. Sie haben auch Composer, den PHP-Paketmanager, installiert und ihn als Medium für die Installation von Laravel verwendet. Mit diesem Wissen können Sie jetzt Ihre Anwendung mit dem Laravel-Web-Framework und MariaDB als Datenbank für Ihre Anwendungen entwickeln.