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. Go to Websites & Domains, find the domain that will host your application, and then open the „Hosting & DNS“ tab.
  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 Protokoll-Browser 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.

Putting Your Application in Maintenance Mode

To prevent website visitors from seeing errors while you are working on or updating your application, you can put it in maintenance mode. While your application is in maintenance mode, website visitors will see a page showing a „503 SERVICE UNAVAILABLE“ error.

Putting your application in maintenance mode

  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. Click the Maintenance mode toggle button so that it shows „Enabled“.

Your Laravel application is now in maintenance mode.

Bemerkung: Do not forget to take your application out of maintenance mode once you have finished working on or updating it.

Aktualisieren Ihrer Anwendung

Whether your Laravel application’s files are stored in a local or a remote Git repository, you need to make sure that the changes made to the application’s code are propagated to the Plesk server. You can choose between deploying the changes manually or automatically.

If you need precise control over when your application is updated, we recommend updating it manually. This way, no changes made to the application’s code in the repository are propagated to the Plesk server until you are ready to do so. The downside of this approach is that you must perform manual actions every time the application needs to be updated.

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. Go to the „Deployment“ tab and, under „Deployment mode“, select the „Manual“ radio button.
  4. Under „Deployment scenario“, clear the checkboxes corresponding to the steps you do not want to run during deployment, and then click Deploy.

Once Laravel Toolkit has run through all the deployment steps, your application and its dependencies will be updated.

If you want the changes made to the application’s code to be automatically propagated to the Plesk server, the method differs depending on whether the application’s code is stored in a local or a remote Git repository.

Updating your application automatically (local 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. Go to the „Deployment“ tab and under „Deployment mode“ select the „Automatic“ radio button.
  4. Under „Deployment scenario“, clear the checkboxes corresponding to the steps you do not want to run during deployment.

Now, every time a commit is pushed to the master branch of the local repository storing the application’s code, your application and its dependencies will be updated.

Updating your application automatically (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. Copy the webhook URL you see here, and then add it to the remote repository. For specific instructions, see your repository provider’s documentation.
  4. Go to the „Deployment“ tab and under „Deployment mode“ select the „Automatic“ radio button.
  5. Under „Deployment scenario“, clear the checkboxes corresponding to the steps you do not want to run during deployment.

Now, every time the event triggering the webhook takes place in the remote repository storing the application’s code, your application and its dependencies will be updated.

Configuring a Deployment Script

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.

Enabling the ability to edit the deployment script in Plesk for 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.