Inhalt: Das Laravel-Toolkit ist eine kostenlose Plesk-Erweiterung, mit der Sie Routineaufgaben im Zusammenhang mit dem Hosting von Laravel-Anwendungen vereinfachen können.

In diesem Artikel erfahren Sie, wie Sie Laravel-Anwendungen in Plesk hochladen, konfigurieren und ausführen. Dies ist kein Leitfaden zur Erstellung von Laravel-Anwendungen. Es wird hier davon ausgegangen, dass Sie die Anwendung bereits haben oder dabei sind, eine zu erstellen.

Voraussetzungen

Bevor Sie Laravel-Anwendungen hosten können, muss die kostenlose Laravel-Erweiterung <https://www.plesk.com/extensions/laravel/>`__ auf dem Plesk Server installiert werden:

Sobald die Erweiterung installiert ist, können Sie anfangen. Sie sehen die Schaltfläche Laravel in der Registerkarte auf der linken Seite des Bildschirms und außerdem die Schaltfläche Laravel-Anwendung installieren auf den Domainkarten aller Ihrer Domains.

laravel drawer

laravel domain card install

Hochladen der Anwendung

Vor der Konfiguration und Ausführung Ihrer Anwendung müssen Sie sie auf den Plesk-Server hochladen und im Laravel Toolkit registrieren. Es gibt drei Möglichkeiten, dies zu tun:

  • Erstellen Sie ein Laravel-Skelett Falls Ihre Anwendung in einem Ordner oder einer komprimierten Datei auf Ihrem Computer gespeichert ist, oder falls Sie Ihre Anwendung von Grund auf neu erstellen möchten, kann das Laravel Toolkit die erforderliche Verzeichnisstruktur und auch ein lokales Git-Repository erstellen.
  • Installation aus einem entfernten Git-Repositorium Wenn Ihre Anwendung in einem entfernten Repositorium gespeichert ist, können Sie sie auf dem Plesk Server bereitstellen.
  • Suchen Sie nach einer vorhandenen Anwendung. Wenn Sie Ihre Anwendung bereits in Plesk hochgeladen haben, können Sie Ihre Anwendung im Laravel-Toolkit registrieren, indem Sie danach suchen.

Bemerkung: Um ein Laravel-Skelett zu erstellen oder von einem entfernten Git-Repositorium zu installieren, muss die kostenlose Git-Erweiterung auf dem Plesk-Server installiert sein.

Erstellen eines Laravel-Skeletts

  1. Anmeldung bei Plesk.
  2. Rufen Sie Websites & Domains auf, suchen Sie die Domain, die Ihre Anwendung hosten soll, und klicken Sie dann auf Laravel-Anwendung installieren.
  3. Wählen Sie „Skelett installieren“, und klicken Sie dann auf Anwendung installieren.
  4. Nach der Installation des Skeletts müssen Sie Ihre Anwendungsdateien in Plesk hochladen (zum Beispiel mit FTP oder File Manager) und dabei die Standarddateien nach Bedarf ersetzen.

Installation aus einem entfernten Git-Repositorium

  1. Anmeldung bei Plesk.
  2. Rufen Sie Websites & Domains auf, suchen Sie die Domain, die Ihre Anwendung hosten soll, und klicken Sie dann auf Laravel-Anwendung installieren.
  3. Wählen Sie „Vom Remote-Repositorium installieren“.
  4. Geben Sie die URL des Remote-Repositoriums, das die Dateien Ihrer Anwendung enthält, ein oder fügen Sie sie ein.
  5. Wenn das Remote-Repositorium eine Authentifizierung erfordert, fügen Sie den öffentlichen Schlüssel, den Sie auf dieser Seite sehen, dem Repositorium hinzu.
  6. Klicken Sie auf Anwendung installieren.

Scannen nach einer vorhandenen Anwendung

  1. Anmeldung bei Plesk.
  2. Gehen Sie zu Websites & Domains, suchen Sie die Domain, auf der Ihre Anwendung gehostet wird, und öffnen Sie dann den Tab „Hosting & DNS“.
  3. Klicken Sie auf**Hosting-Einstellungen**.
  4. Ändern Sie den Wert „Document Root“ so, dass er dem Pfad zum öffentlichen Verzeichnis Ihrer Anwendung entspricht (standardmäßig /httpdocs/public), und klicken Sie dann auf OK.
  5. Klicken Sie auf Laravel-Anwendung installieren, klicken Sie auf Abbrechen und dann auf Scannen.

Sobald Sie die Dateien Ihrer Anwendung hochgeladen oder bereitgestellt haben und Ihre Anwendung im Laravel Toolkit registriert wurde, wird die Schaltfläche Laravel-Anwendung installieren durch die Schaltfläche Laravel-Anwendung verwalten für die Domain ersetzt, die Ihre Anwendung hostet.

laravel domain card manage

Sie können nun mit dem nächsten Schritt fortfahren.

Artisan, Composer und Node.js-Befehle ausführen

Um Ihre Laravel-Anwendung zu verwalten, müssen Sie möglicherweise Artisan-, Composer- und/oder Node.js-Befehle ausführen. Mit dem Laravel-Toolkit können Sie diese Befehle ganz einfach über die Plesk-Schnittstelle ausführen, ohne dass Sie einen Shell-Zugang benötigen.

Wenn Sie sich nicht sicher sind, ob Sie irgendwelche Artisan-, Composer- und/oder Node.js-Befehle ausführen müssen, damit Ihre Anwendung ordnungsgemäß läuft, wenden Sie sich an die Person oder Organisation, die Ihnen die Anwendung zur Verfügung gestellt hat.

Bemerkung: Bevor Sie Node.js-Befehle ausführen können, muss die kostenlose Node.js-Erweiterung auf dem Plesk-Server installiert sein.

laravel run commands

Ausführen eines Artisan-, Composer- oder Node.js-Befehls

  1. Anmeldung bei Plesk.

  2. Rufen Sie Webseiten & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, und klicken Sie dann auf Laravel-Anwendung verwalten.

  3. Rufen Sie die entsprechende Registerkarte auf, geben Sie den auszuführenden Befehl ein oder wählen Sie einen aus der Liste aus, und drücken Sie die Eingabetaste oder klicken Sie auf die Schaltfläche laravel run button.

    Bemerkung: Wenn Sie Node.js-Befehle ausführen, müssen Sie möglicherweise eine bestimmte Node.js-Version und/oder einen Paketmanager angeben, damit der Befehl die erwünschte Wirkung hat. Wenn Sie nicht sicher sind, was Sie wählen sollen, wenden Sie sich an die Person oder Organisation, von der Sie die Anwendung erhalten haben.

Anzeigen der Protokolldateien Ihrer Anwendung

Während Ihre Laravel-Anwendung läuft, schreibt sie ihr Protokoll in eine separate Protokolldatei. Sie können den Inhalt dieser Datei direkt von der Laravel-Toolkit-Benutzeroberfläche aus einsehen, um die Überwachung Ihrer Anwendung und die Fehlerbehebung bei auftretenden Problemen zu erleichtern.

laravel view logs

Aufrufen des Protokolls Ihrer Anwendung

  1. Anmeldung bei Plesk.
  2. Rufen Sie Webseiten & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, und klicken Sie dann auf Laravel-Anwendung verwalten.
  3. Klicken Sie auf Protokolle.

Dadurch wird der Protokollbrowser der Domain geöffnet, der nur die Protokolleinträge aus dem Laravel-Protokoll anzeigt.

Anzeigen der geplanten Aufgaben Ihrer Anwendung

Mit Laravel können Sie Aufgaben innerhalb des Codes der Anwendung planen, anstatt einen externen Planer, wie z. B. cron, zu verwenden. Mit dem Laravel Toolkit können Sie direkt von der Benutzeroberfläche des Laravel Toolkits aus alle aktuell konfigurierten geplanten Aufgaben sehen und auch die geplanten Laravel-Aufgaben aktivieren oder deaktivieren.

Bemerkung: Sie können keine geplanten Laravel-Aufgaben über die Laravel Toolkit-Schnittstelle hinzufügen, entfernen oder bearbeiten. Erfahren Sie, wie man Aufgaben im Code der Anwendung plant <https://laravel.com/docs/9.x/scheduling>`__

laravel view scheduled tasks

Anzeigen der geplanten Aufgaben Ihrer Anwendung

  1. Anmeldung bei Plesk.
  2. Rufen Sie Webseiten & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, und klicken Sie dann auf Laravel-Anwendung verwalten.
  3. Rufen Sie die Registerkarte „Geplante Aufgaben“ auf (die Registerkarte ist nur sichtbar, wenn eine oder mehrere geplante Aufgaben konfiguriert sind).

Bemerkung: Um die geplanten Aufgaben Ihrer Anwendung aktivieren oder deaktivieren zu können, müssen Sie zunächst einen bestimmten Vorgang durchführen, je nachdem, ob Sie Plesk für Linux oder Plesk für Windows verwenden. Diese Operation müssen Sie für jede Domain durchführen, die eine Laravel-Anwendung hostet, deren geplante Aufgaben Sie ausführen möchten.

Aktivieren der Verwaltung geplanter Aufgaben in Plesk für Linux

  1. Anmeldung bei Plesk.
  2. Rufen Sie Websites & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, gehen Sie zur Registerkarte „Hosting & DNS“ und klicken Sie dann auf Webhosting-Zugang.
  3. Wählen Sie unter „Zugriff auf den Server über SSH“ eine andere Option als „Verboten“ und klicken Sie dann auf OK.

Aktivieren der Verwaltung geplanter Aufgaben in Plesk für Windows

  1. Anmeldung bei Plesk.
  2. Rufen Sie Webseiten & Domains auf und suchen Sie die Domain, die Ihre Anwendung hostet.
  3. Klicken Sie unter „Konto“ auf Anpassen.
  4. Rufen Sie die Registerkarte „Berechtigungen“ auf, aktivieren Sie das Kontrollkästchen neben „Planerverwaltung“ und klicken Sie dann auf Aktualisieren & Sperren.

Sie können jetzt die geplanten Aufgaben Ihrer Anwendung aktivieren oder deaktivieren.

Aktivieren der geplanten Aufgaben für Ihre Anwendung

  1. Anmeldung bei Plesk.
  2. Rufen Sie Webseiten & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, und klicken Sie dann auf Laravel-Anwendung verwalten.
  3. Klicken Sie auf die Schaltfläche Geplante Aufgaben, so dass sie „Aktiviert“ anzeigt.

Geplante Aufgaben sind jetzt für Ihre Laravel-Anwendung aktiviert.

Bearbeiten der Umgebungsvariablen

Ihre Anwendung benötigt möglicherweise eine oder mehrere benutzerdefinierte Umgebungsvariablen, um ordnungsgemäß zu laufen, oder sie ändert ihr Verhalten in Abhängigkeit von den gesetzten Umgebungsvariablen. Sollten Sie sich nicht sicher sein, ob Ihre Anwendung Umgebungsvariablen benötigt, um ordnungsgemäß zu laufen, wenden Sie sich an die Person oder Organisation, die Ihnen die Anwendung zur Verfügung gestellt hat.

Bearbeiten von Umgebungsvariablen

  1. Anmeldung bei Plesk.
  2. Rufen Sie Webseiten & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, und klicken Sie dann auf Laravel-Anwendung verwalten.
  3. Klicken Sie auf die Schaltfläche Bearbeiten neben „Umgebungsvariablen (.env)“.
  4. Bearbeiten Sie die Umgebungsvariablen nach Bedarf, und klicken Sie dann auf Aktualisieren.

Die aktualisierten Umgebungsvariablen werden jetzt angewendet.

Versetzung Ihrer Anwendung in den Wartungsmodus

Um zu verhindern, dass Website-Besucher Fehler sehen, während Sie an Ihrer Anwendung arbeiten oder sie aktualisieren, können Sie sie in den Wartungsmodus versetzen. Während sich Ihre Anwendung im Wartungsmodus befindet, sehen Website-Besucher eine Seite mit der Fehlermeldung „503 SERVICE UNAVAILABLE“.

Versetzung Ihrer Anwendung in den Wartungsmodus

  1. Anmeldung bei Plesk.
  2. Rufen Sie Webseiten & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, und klicken Sie dann auf Laravel-Anwendung verwalten.
  3. Klicken Sie auf die Schaltfläche Wartungsmodus, so dass sie „Aktiviert“ anzeigt.

Ihre Laravel-Anwendung befindet sich jetzt im Wartungsmodus.

Bemerkung: Denken Sie daran, den Wartungsmodus Ihrer Anwendung zu beenden, wenn Sie die Arbeit daran oder die Aktualisierung abgeschlossen haben.

Aktualisieren Ihrer Anwendung

Unabhängig davon, ob die Dateien Ihrer Laravel-Anwendung in einem lokalen oder einem Remote-Git-Repository gespeichert sind, müssen Sie dafür sorgen, dass die am Code der Anwendung vorgenommenen Änderungen auf den Plesk Server übertragen werden. Sie können wählen, ob Sie die Änderungen manuell oder automatisch bereitstellen möchten.

Wenn Sie genau bestimmen möchten, wann Ihre Anwendung aktualisiert wird, empfehlen wir Ihnen, sie manuell zu aktualisieren. Auf diese Weise werden Änderungen am Code der Anwendung im Repository erst dann an den Plesk Server weitergegeben, wenn Sie bereit sind, dies zu tun. Der Nachteil dieses Ansatzes ist, dass Sie jedes Mal, wenn die Anwendung aktualisiert werden muss, manuelle Aktionen durchführen müssen.

Manuelles Aktualisieren Ihrer Anwendung

  1. Anmeldung bei Plesk.
  2. Rufen Sie Webseiten & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, und klicken Sie dann auf Laravel-Anwendung verwalten.
  3. Gehen Sie zum Tab „Bereitstellung“ und wählen Sie unter „Bereitstellungsmodus“ das Optionsfeld „Manuell“.
  4. Deaktivieren Sie unter „Bereitstellungsszenario“ die Kontrollkästchen für die Schritte, die Sie während der Bereitstellung nicht ausführen möchten, und klicken Sie dann auf Bereitstellen.

Sobald das Laravel Toolkit alle Bereitstellungsschritte durchlaufen hat, werden Ihre Anwendung und ihre Abhängigkeiten aktualisiert.

Wenn Sie möchten, dass die am Code der Anwendung vorgenommenen Änderungen automatisch auf den Plesk Server übertragen werden, unterscheidet sich die Methode je nachdem, ob der Code der Anwendung in einem lokalen oder einem Remote-Git-Repository gespeichert ist.

Automatische Aktualisierung Ihrer Anwendung (lokales Repository)

  1. Anmeldung bei Plesk.
  2. Rufen Sie Webseiten & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, und klicken Sie dann auf Laravel-Anwendung verwalten.
  3. Gehen Sie zum Tab „Bereitstellung“ und wählen Sie unter „Bereitstellungsmodus“ das Optionsfeld „Automatisch“.
  4. Deaktivieren Sie unter „Bereitstellungsszenario“ die Kontrollkästchen für die Schritte, die Sie während der Bereitstellung nicht ausführen möchten.

Jedes Mal, wenn ein Commit in den master-Zweig des lokalen Repositorys verschoben wird, in dem der Code der Anwendung gespeichert ist, werden Ihre Anwendung und ihre Abhängigkeiten aktualisiert.

Automatische Aktualisierung Ihrer Anwendung (Remote-Repository)

  1. Anmeldung bei Plesk.
  2. Rufen Sie Webseiten & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, und klicken Sie dann auf Laravel-Anwendung verwalten.
  3. Kopieren Sie die Webhook-URL, die Sie hier sehen, und fügen Sie sie dann dem Remote-Repository hinzu. Genaue Anweisungen finden Sie in der Dokumentation Ihres Repository-Anbieters.
  4. Gehen Sie zum Tab „Bereitstellung“ und wählen Sie unter „Bereitstellungsmodus“ das Optionsfeld „Automatisch“.
  5. Deaktivieren Sie unter „Bereitstellungsszenario“ die Kontrollkästchen für die Schritte, die Sie während der Bereitstellung nicht ausführen möchten.

Jetzt werden Ihre Anwendung und ihre Abhängigkeiten jedes Mal aktualisiert, wenn das Ereignis, das den Webhook auslöst, in dem Remote-Repository stattfindet, in dem der Code der Anwendung gespeichert ist.

Konfiguration eines Bereitstellungsskripts

Ihre Anwendung benötigt möglicherweise bestimmte Befehle, die während der Bereitstellung auf dem Server ausgeführt werden müssen, um ordnungsgemäß zu funktionieren. Damit Sie diese Befehle nicht manuell ausführen müssen, können Sie ein Bereitstellungs-Skript konfigurieren, das jedes Mal ausgeführt wird, wenn die Anwendung aktualisiert wird.

Sollten Sie sich nicht sicher sein, ob Ihre Anwendung während der Bereitstellung irgendwelche Befehle ausführen muss, um ordnungsgemäß zu funktionieren, wenden Sie sich an die Person oder Organisation, die Ihnen die Anwendung zur Verfügung gestellt hat.

Bemerkung: In Plesk für Linux müssen Sie den SSH-Zugang aktivieren, bevor Sie das Bereitstellungs-Skript über die Benutzeroberfläche des Laravel Toolkits bearbeiten können. Sie müssen dies nur einmal durchführen.

Aktivierung der Bearbeitung des Bereitstellungsskripts in Plesk für Linux

  1. Anmeldung bei Plesk.
  2. Rufen Sie Websites & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, gehen Sie zur Registerkarte „Hosting & DNS“ und klicken Sie dann auf Webhosting-Zugang.
  3. Wählen Sie unter „Zugriff auf den Server über SSH“ eine andere Option als „Verboten“ und klicken Sie dann auf OK.

Sie können das Bereitstellungs-Skript jetzt über die Oberfläche des Laravel Toolkits bearbeiten.

Bearbeiten des Bereitstellungs-Skripts

  1. Anmeldung bei Plesk.
  2. Rufen Sie Webseiten & Domains auf, suchen Sie die Domain, die Ihre Anwendung hostet, und klicken Sie dann auf Laravel-Anwendung verwalten.
  3. Rufen Sie die Registerkarte „Bereitstellung“ auf und klicken Sie dann auf Skript bearbeiten.
  4. Geben Sie Ihr Bereitstellungs-Skript ein oder fügen Sie es ein, und klicken Sie dann auf Aktualisieren.

Das Bereitstellungs-Skript ist nun aktiv und wird jedes Mal ausgeführt, wenn Sie Ihre Anwendung aktualisieren.