Tutorial: Erstellen einer PHP (Laravel) und Azure Database for MySQL – Flexible Server-Anwendung auf Azure App Service

  • Artikel

GILT FÜR: Azure Database for MySQL – Flexibler Server

Azure App Service bietet einen hochgradig skalierbaren Webhostingdienst mit Self-Patching unter dem Linux-Betriebssystem. In diesem Tutorial wird gezeigt, wie Sie eine sichere PHP-App in Azure App Service erstellen, die mit einer MySQL-Datenbank verbunden ist (mit einem flexiblen Server von Azure Database for MySQL). Wenn Sie fertig sind, verfügen Sie über eine Laravel-App, die in Azure App Service für Linux ausgeführt wird.

Screenshot of the Azure app example titled Task List showing new tasks added.

In diesem Tutorial lernen Sie Folgendes:

  • Erstellen einer sicheren standardmäßigen PHP- und MySQL-App in Azure
  • Konfigurieren von Verbindungsschlüsseln in MySQL mithilfe von App-Einstellungen
  • Bereitstellen von Anwendungscode mithilfe von GitHub Actions
  • Aktualisieren und erneutes Bereitstellen der App
  • Sichere Durchführung von Datenbankmigrationen
  • Streamen von Diagnoseprotokollen aus Azure
  • Verwalten der App im Azure-Portal

Voraussetzungen

Beispielanwendung

Führen Sie für dieses Tutorial das Klonen oder Herunterladen der Beispielanwendung aus dem Repository durch:

git clone https://github.com/Azure-Samples/laravel-tasks.git

Wenn Sie die Anwendung lokal ausführen möchten, gehen Sie wie folgt vor:

  • Konfigurieren Sie in .env die Datenbankeinstellungen (wie DB_DATABASE, DB_USERNAME undDB_PASSWORD) mithilfe von Einstellungen in Ihrer lokalen Azure Database for MySQL flexible Serverdatenbank. Sie benötigen eine lokale Azure Database for MySQL für die flexible Serverinstanz, um dieses Beispiel auszuführen.

  • Starten Sie aus dem Stamm des Repositorys Laravel mit den folgenden Befehlen:

    composer install
php artisan migrate
php artisan key:generate
php artisan serve

1 - Erstellen von App Service und Azure Database for MySQL für flexible Serverressourcen

In diesem Schritt erstellen Sie die Azure-Ressourcen. Mit den Schritten in diesem Tutorial erstellen Sie eine flexible Serverkonfiguration für App Service und Azure Database for MySQL, die standardmäßig sicher ist. Für den Erstellungsprozess geben Sie Folgendes an:

  • Den Namen für die Web-App. Dieser Name wird als Teil des DNS-Namens für Ihre Web-App im Format https://<app-name>.azurewebsites.net verwendet.
  • Die Runtime für die App. Hier wählen Sie die Version von PHP aus, die für Ihre App verwendet werden soll.
  • Die Ressourcengruppe für die App. Mit einer Ressourcengruppe können Sie (in einem logischen Container) alle für die Anwendung benötigten Azure-Ressourcen gruppieren.

Melden Sie sich beim Azure-Portal an, und führen Sie die folgenden Schritte aus, um Ihre Azure App Service-Ressourcen zu erstellen.

Anweisungen Screenshot
Im Azure-Portal:
  1. Geben Sie auf der Suchleiste oben im Azure-Portal „Web App Datenbank“ ein.
  2. Wählen Sie das Element mit der Bezeichnung Web-App + Datenbank unter der Überschrift Marketplace aus.
Sie können auch direkt zum Erstellungs-Assistenten navigieren.		 A screenshot showing how to use the search box in the top tool bar to find the Web App + Database creation wizard.
Füllen Sie das Formular auf der Seite Web-App + Datenbank erstellen wie folgt aus.

  1. Ressourcengruppe → Wählen Sie die Option Neu erstellen aus, und verwenden Sie einen Namen wie msdocs-expressjs-mongodb-tutorial.

  2. Region: Eine beliebige Azure-Region in Ihrer Nähe.

  3. Name → msdocs-expressjs-mongodb-XYZ, wobei XYZ für drei beliebige Zeichen steht. Dieser Name muss innerhalb von Azure eindeutig sein.

  4. Runtimestapel → .NET 8.0.

    MySQL – Flexibler Server ist standardmäßig als Datenbankmodul ausgewählt. Azure Database for MySQL ist eine vollständig verwaltete MySQL-Datenbank als Dienst auf Azure, kompatibel mit den neuesten Community-Editionen.

  5. Beachten Sie den Datenbanknamen, der für Sie generiert wird (<App-Name-Datenbank>). Sie benötigen die Information später.

  6. Klicken Sie auf Überprüfen + erstellen.

Klicken Sie nach Abschluss der Prüfung auf Erstellen.		 A screenshot showing how to configure a new app and database in the Web App + Database wizard.
Die Bereitstellung dauert einige Minuten, bis die Bereitstellung abgeschlossen ist, und erstellt die folgenden Ressourcen:
  • Ressourcengruppe → Der Container für alle erstellten Ressourcen.
  • App Service-Plan → Definiert die Berechnungsressourcen für App Service. Ein Linux-Plan auf der P1v2-Ebene wird erstellt.
  • App Service → Stellt Ihre App dar und wird im App Service Plan ausgeführt.
  • Virtuelles Netzwerk → Integriert mit der App Service App und isoliert den Backend-Netzwerkdatenverkehr.
  • Azure Database for MySQL – Flexible Server → Nur über das virtuelle Netzwerk zugänglich. Eine Datenbank und ein Benutzer werden für Sie auf dem Server erstellt.
  • Privates DNS Zone → Aktiviert die DNS-Auflösung des MySQL-Datenbankservers im virtuellen Netzwerk.
Wählen Sie nach Abschluss der Bereitstellung die Schaltfläche Zu Ressource wechseln aus. Sie werden direkt zur App Service App weitergeleitet.		 A screenshot showing the form to fill out to create a web app in Azure.

2 – Einrichten der Datenbankkonnektivität

Der Erstellungsassistent generierte App-Einstellungen, die Sie zum Herstellen einer Verbindung mit der Datenbank verwenden können, aber nicht in einem Format, das derzeit für Ihren Code brauchbar ist. In diesem Schritt bearbeiten und aktualisieren Sie App-Einstellungen in das Format, das Ihre App benötigt.

Anweisungen Screenshot
Wählen Sie im linken Menü auf der App Service-Seite Konfiguration aus. A screenshot showing how to open the configuration page in App Service.
Klicken Sie auf der Registerkarte Anwendungseinstellungen der Seite Konfiguration für jede der folgenden Einstellungen auf Bearbeiten, aktualisieren Sie das Feld Name mit neuen Werten, und klicken Sie auf OK.
Aktueller Name Neuer Name
AZURE_MYSQL_DBNAME DB_DATABASE
AZURE_MYSQL_HOST DB_HOST
AZURE_MYSQL_USERNAME DB_USERNAME
AZURE_MYSQL_PASSWORD DB_PASSWORD
A screenshot showing how to see the autogenerated connection string.
Erstellen Sie eine neue MYSQL_ATTR_SSL_CA-Datenbankeinstellung:

  1. Klicken Sie auf Neue Anwendungseinstellung.

  2. Geben sie im Feld Name den Wert MYSQL_ATTR_SSL_CA ein.

  3. Geben Sie im Feld Wert den Wert /home/site/wwwroot/ssl/DigiCertGlobalRootCA.crt.pem ein.

    Diese App-Einstellung verweist auf den Pfad des TLS/SSL-Zertifikats, das Sie benötigen, um auf den MySQL-Server zuzugreifen. Es ist praktischerweise im Beispiel-Repository enthalten.

  4. Klicken Sie auf OK.

 A screenshot showing how to create an app setting.
Erstellen Sie die folgenden zusätzlichen App-Einstellungen, indem Sie die gleichen Schritte durchführen, und klicken Sie dann auf Speichern.

  • APP_DEBUG: Verwenden Sie true als Wert. Dies ist eine Laravel-Debugvariable.

  • APP_KEY: Verwenden Sie base64:Dsz40HWwbCqnq0oxMsjq7fItmKIeBfCBGORfspaI1Kw= als Wert. Dies ist eine Laravel-Verschlüsselungsvariable.

    Wichtig

    Dieser APP_KEY-Wert wird hier praktischerweise verwendet. Für Produktionsszenarien sollte er speziell für Ihre Bereitstellung mit php artisan key:generate --show in der Befehlszeile generiert werden.

 A screenshot showing all the required app settings in the configuration page.

3 – Bereitstellen von Beispielcode

In diesem Schritt konfigurieren Sie die GitHub-Bereitstellung mithilfe von GitHub Actions. Es ist nur eine der vielen Möglichkeiten, um App Service bereitzustellen, aber auch eine hervorragende Möglichkeit, eine kontinuierliche Integration in Ihren Bereitstellungsprozess zu haben. Standardmäßig startet jede git push in Ihrem GitHub-Repository die Build- und Bereitstellungsaktion. Sie nehmen einige Änderungen an Ihrer Codebase mit Visual Studio Code direkt im Browser vor und lassen dann GitHub Actions automatisch für Sie bereitstellen.

Anweisungen Screenshot
In einem neuen Browserfenster:

  1. Melden Sie sich bei Ihrem GitHub-Konto an.

  2. Navigiere zu https://github.com/Azure-Samples/laravel-tasks.

  3. Klicke auf Forken.

  4. Klicken Sie auf Verzweigung erstellen.

 A screenshot showing how to create a fork of the sample GitHub repository.
Öffnen Sie auf der GitHub-Seite Visual Studio Code im Browser, indem Sie die .-Taste drücken. A screenshot showing how to open the Visual Studio Code browser experience in GitHub.
Öffnen Sie in Visual Studio Code im Browser config/database.php im Explorer. Sehen Sie, dass in der mysql-Verbindung die App-Einstellungen, die Sie zuvor für die MySQL-Verbindung erstellt haben, bereits verwendet werden (DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD, MYSQL_ATTR_SSL_CA). A screenshot showing Visual Studio Code in the browser and an opened file.
Wählen Sie, wenn Sie wieder auf der App Service-Seite sind, im linken Menü Bereitstellungscenter aus. A screenshot showing how to open the deployment center in App Service.
Auf der Seite Bereitstellungscenter:

  1. Wählen Sie in Quelle die Option GitHub aus. Standardmäßig wird GitHub Actions als Buildanbieter ausgewählt.

  2. Melden Sie sich bei Ihrem GitHub-Konto an und folgen Sie der Aufforderung, Azure zu autorisieren.

  3. Wählen Sie in Organisation Ihr Konto aus.

  4. Wählen Sie im Repositorydie Option Laravel-Aufgaben aus.

  5. Wählen Sie in Branch die Option Hauptbereich aus.

  6. Klicken Sie im oberen Menü auf Speichern.

App Service committet eine Workflowdatei in das ausgewählte GitHub-Repository im .github/workflows-Verzeichnis.		 A screenshot showing how to configure CI/CD using GitHub Actions.
Auf der Seite Bereitstellungscenter:

  1. Wählen Sie Protokolle aus. Eine Bereitstellungsausführung wird bereits gestartet.

  2. Wählen Sie im Protokollelement für die Bereitstellungsausführung die Option Build/Deploy Logs aus.

    Sie werden an Ihr GitHub-Repository weitergeleitet und sehen, dass die GitHub-Aktion ausgeführt wird. Die Workflowdatei definiert zwei separate Phasen, Erstellen und Bereitstellen.

 A screenshot showing how to open deployment logs in the deployment center.
Um Änderungen an Ihrem Code vorzunehmen, gehen Sie im Browser zu Visual Studio Code:

  1. Wählen Sie die Quellsteuerungserweiterung aus.

  2. Wählen Sie neben der geänderten database.php die Option + aus, um Ihre Änderungen zu stufen.

  3. Geben Sie im Textfeld eine Commitnachricht ein, z.B. add certificate.

  4. Aktivieren Sie das Häkchen zum Commit und Push an GitHub.

Wenn Sie zur Seite „Bereitstellungscenter“ zurückkehren, wird ein neuer Protokolleintrag angezeigt, da eine andere Ausführung gestartet wird. Warten Sie, bis die Ausführung abgeschlossen ist. Das Upgrade dauert ca. 15 Minuten.

Tipp

Die GitHub-Aktion wird durch die Datei im GitHub-Repository in .github/workflow definiert. Sie können es schneller machen, indem Sie die Datei anpassen.

 A screenshot showing how to commit your changes in the Visual Studio Code browser experience.

4 – Generieren des Datenbankschemas

Der Erstellungsassistent stellt die flexible Serverinstanz von Azure Database for MySQL hinter einen privaten Endpunkt, sodass sie nur über das virtuelle Netzwerk zugänglich ist. Da die App Service-App bereits mit dem virtuellen Netzwerk integriert ist, ist die einfachste Möglichkeit, Datenbankmigrationen mit Ihrer Datenbank direkt im App Service-Container auszuführen.

Anweisungen Screenshot
Auf der App Service-Seite:

  1. Klicken Sie im linken Menü auf SSH.

  2. Klicken Sie auf Starten.

Eine SSH-Sitzung mit Ihrem App Service-Container wird im Browser geöffnet. Wenn Sie möchten, können Sie stattdessen direkt zu https://<app-name>.scm.azurewebsites.net/webssh/host navigieren.		 A screenshot showing how to open the SSH shell for your app from the Azure portal.
Im SSH-Terminal:

  1. CD im Stamm des Anwendungscodes:

    cd /home/site/wwwroot

  2. Führen Sie Datenbankmigrationen aus Ihrem Anwendungsstamm aus.

    php artisan migrate --force

    Hinweis

    Nur Änderungen an Dateien in /home können über den Neustart der App hinaus beibehalten werden. Änderungen außerhalb von /home werden nicht beibehalten.

 A screenshot showing the commands to run in the SSH shell and their output.

5 – Ändern des Sitestammverzeichnisses

Der Lebenszyklus der Laravel-Anwendung beginnt im öffentlichen Verzeichnis anstatt im Stammverzeichnis der Anwendung. Der Standard-PHP 8.0-Container für App Service verwendet Nginx, das im Stammverzeichnis der Anwendung beginnt. Um den Websitestamm zu ändern, müssen Sie die Nginx-Konfigurationsdatei im PHP 8.0-Container (/etc/nginx/sites-available/default) ändern. Praktischerweise enthält das Beispiel-Repository eine benutzerdefinierte Konfigurationsdatei namens Standard. Wie zuvor erwähnt, sollten Sie diese Datei nicht mithilfe der SSH-Shell ersetzen, da Ihre Änderungen nach einem App-Neustart verloren gehen.

Anweisungen Screenshot
Auf der App Service-Seite:

  1. Klicken Sie im linken Menü auf Konfiguration.

  2. Wählen Sie die Registerkarte Allgemeine Einstellungen aus.

 A screenshot showing how to open the general settings tab in the configuration page of App Service.
In der Registerkarte Allgemeine Einstellungen:

  1. Geben Sie im Feld Startbefehl den folgenden Befehl ein: cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload.

    Er ersetzt die Nginx-Konfigurationsdatei im PHP 8.0-Container und startet Nginx neu. Diese Konfiguration stellt sicher, dass diese Änderung jedes Mal an den Container vorgenommen wird, wenn sie gestartet wird.

  2. Wählen Sie Speichern.

 A screenshot showing how to configure a startup command in App Service.

6 – Navigieren zur App

Anweisungen Screenshot
Auf der App Service-Seite:

  1. Wählen Sie im Menü auf der linken Seite die Option Übersicht aus.

  2. Wählen Sie die URL Ihrer App aus.

    Sie können auch direkt zu https://<app-name>.azurewebsites.net navigieren.

 A screenshot showing how to launch an App Service from the Azure portal.
Glückwunsch! Sie führen eine datengesteuerte PHP-App in Azure App Service aus. A screenshot of the Laravel app running in App Service.

7. Streamen von Diagnoseprotokollen

Anweisungen Screenshot
Auf der App Service-Seite:

  1. Wählen Sie im linken Menü App Service-Protokolle aus.

  2. Wählen Sie unter Anwendungsprotokollierung die Option Dateisystem aus.

 A screenshot showing how to enable native logs in App Service in the Azure portal.
Klicken Sie im linken Menü auf Protokolldatenstrom. Sie sehen die Protokolle für Ihre App, einschließlich Plattformprotokolle und Protokolle innerhalb des Containers. A screenshot showing how to view the log stream in the Azure portal.

Bereinigen von Ressourcen

Wenn Sie fertig sind, können Sie alle Ressourcen aus Ihrem Azure-Abonnement löschen, indem Sie die Ressourcengruppe löschen.

Anweisungen Screenshot
In der Suchleiste oben im Azure-Portal:

  1. Geben Sie den Ressourcengruppennamen ein.

  2. Wählen Sie die Ressourcengruppe aus.

 A screenshot showing how to search for and navigate to a resource group in the Azure portal.
Klicken Sie auf der Seite für die Ressourcengruppe auf die Option Ressourcengruppe löschen. A screenshot showing the location of the Delete Resource Group button in the Azure portal.

  1. Geben Sie den Namen der Ressourcengruppe ein, um Ihre Löschung zu bestätigen.

  2. Klicken Sie auf Löschen.

 A screenshot of the confirmation dialog for deleting a resource group in the Azure portal.

Häufig gestellte Fragen

Wie viel kostet diese Einrichtung?

Die Preise für die Erstellungsressourcen sind wie folgt:

  • Der App Service Plan wird auf Premium V2-Ebene erstellt und kann nach oben oder unten skaliert werden. Informationen dazu finden Sie unter App Service – Preise.
  • Die flexible Serverinstanz von Azure Database for MySQL wird in der B1ms-Ebene erstellt und kann nach oben oder unten skaliert werden. Mit einem kostenlosen Azure-Konto ist die B1ms-Stufe für 12 Monate bis zu den monatlichen Grenzwerten kostenlos. Siehe Azure Database for MySQL flexible Serverpreise.
  • Das virtuelle Netzwerk hat keine Gebühr, es sei denn, Sie konfigurieren zusätzliche Funktionen, z. B. Peering. Siehe Azure Virtual Network Preise.
  • Die private DNS-Zone verursacht eine kleine Gebühr. Siehe Azure DNS-Preise.

Wie kann ich eine Verbindung mit einer flexiblen Azure-Serverdatenbank for MySQL herstellen, die hinter einem virtuellen Netzwerk gesichert ist?

Um eine Verbindung mit einer flexiblen Azure-Database for MySQL herzustellen, können Sie verschiedene Methoden basierend auf den Tools und Umgebungen verwenden, die Ihnen zur Verfügung stehen:

  • Zugriff auf das Befehlszeilentool:
    • Verwenden Sie den Befehl mysql über das SSH-Terminal der App für den einfachen Zugriff.
  • Desktoptools (z. B. MySQL Workbench):
    • Verwenden von SSH-Tunneling mit der Azure CLI:
      • Erstellen Sie mithilfe der Azure CLI eine SSH-Sitzung für die Web-App.
      • Verwenden Sie die SSH-Sitzung, um den Datenverkehr zu MySQL zu tunneln.
    • Verwenden von Site-to-Site-VPN oder Azure VM:
      • Ihr Computer muss Teil des virtuellen Netzwerks sein.
      • Mögliche Verwendung von:
        • Eine Azure VM, die mit einem der Subnetze verknüpft ist.
        • Ein Rechner in einem lokalen Netzwerk, der über eine Site-to-Site-VPN-Verbindung mit dem virtuellen Azure-Netzwerk verbunden ist.
  • Azure Cloud Shell-Integration:

Wie funktioniert die lokale App-Entwicklung mit GitHub Actions?

Nehmen Sie die automatisch generierte Workflowdatei von App Service als Beispiel; jede git push startet eine neue Build- und Bereitstellungsausführung. Aus einem lokalen Klon des GitHub-Repositorys können Sie die gewünschten Updates zu GitHub pushen. Beispiel:

git add .
git commit -m "<some-message>"
git push origin main

Warum ist die GitHub Actions-Bereitstellung so langsam?

Die automatisch generierte Workflowdatei aus App Service definiert die Zwei-Aufträge-Ausführung „Erstellen, dann bereitstellen“. Da jeder Auftrag in einer eigenen sauberen Umgebung ausgeführt wird, stellt die Workflowdatei sicher, dass der deploy-Auftrag Zugriff auf die Dateien aus dem build-Auftrag hat:

  • Laden Sie am Ende des build-Auftrags Dateien als Artefakte hoch.
  • Laden Sie am Anfang des deploy-Auftrags die Artefakte herunter.

Die meiste Zeit wird vom Zweiauftragsprozess darauf verwendet, Artefakte hoch- und herunterzuladen. Wenn Sie möchten, können Sie die Workflowdatei vereinfachen, indem Sie die beiden Aufträge in einen kombinieren, wodurch die Notwendigkeit für das Hochladen und Herunterladen entfernt wird.

Zusammenfassung

In diesem Tutorial haben Sie Folgendes gelernt:

  • Erstellen einer sicheren standardmäßigen PHP- und Azure-Database for MySQL flexibler Server-App in Azure
  • Konfigurieren von Verbindungsgeheimnissen mit Azure Database for MySQL flexiblen Server mithilfe von App-Einstellungen
  • Bereitstellen von Anwendungscode mithilfe von GitHub Actions
  • Aktualisieren und erneutes Bereitstellen der App
  • Sichere Durchführung von Datenbankmigrationen
  • Streamen von Diagnoseprotokollen aus Azure
  • Verwalten der App im Azure-Portal

Nächste Schritte

Tutorial: Zuordnen eines benutzerdefinierten DNS-Namens zu Ihrer App

Verwalten von Ressourcen im Azure-Portal

Verwalten Ihres Servers