In dieser Anleitung wird gezeigt, wie Sitzungen in App Engine verarbeitet werden.
Viele Anwendungen benötigen eine Sitzungsverarbeitung zur Authentifizierung und für Nutzereinstellungen. PHP bietet eine arbeitsspeicherbasierte Implementierung zum Ausführen dieser Funktion. Diese Implementierung eignet sich jedoch nicht für eine Anwendung, die über mehrere Instanzen bereitgestellt werden kann, da sich die Sitzung, die in einer bestimmten Instanz aufgezeichnet wird, von Sitzungen in anderen Instanzen unterscheiden kann.
Lernziele
- Anwendung schreiben
- Anwendung lokal ausführen
- Anwendung in App Engine bereitstellen
Kosten
In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:
Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.
Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.
Hinweise
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Enable the Firestore API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Enable the Firestore API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Konfigurieren Sie die gcloud CLI für die Verwendung Ihres neuen Google Cloud-Projekts:
Ersetzen Sie# Configure gcloud for your project gcloud config set project PROJECT_ID
PROJECT_ID
durch die Google Cloud-Projekt-ID, die Sie zuvor erstellt oder ausgewählt haben.
Projekt einrichten
Beginnen Sie im Terminalfenster in einem Verzeichnis Ihrer Wahl und erstellen Sie ein neues Verzeichnis mit dem Namen
sessions
. Der gesamte Code für diese Anleitung befindet sich im Verzeichnissessions
.Wechseln Sie in das Verzeichnis
sessions
:cd sessions
Installieren Sie die Abhängigkeiten:
composer require google/cloud-firestore
Am Ende dieser Anleitung sieht die endgültige Dateistruktur etwa so aus:
sessions
├── app.yaml
└── composer.json
├── index.php
Anwendung schreiben
Erstellen Sie im Terminalfenster eine Datei mit dem Namen
index.php
mit folgendem Inhalt:
In dieser Anwendung werden Begrüßungen in verschiedenen Sprachen für jeden Nutzer angezeigt. Wiederkehrende Nutzer werden immer in derselben Sprache begrüßt.
Bevor sich in der Anwendung die Einstellungen für einen Nutzer speichern lassen, benötigen Sie eine Möglichkeit zum Speichern der Informationen über den aktuellen Nutzer in einer Sitzung. In dieser Beispielanwendung werden Sitzungsdaten mit Firestore gespeichert.
Sie können den Firestore session handler
verwenden, um Firestore für PHP-Sitzungen einzusetzen.
Das folgende Diagramm veranschaulicht, wie Firestore Sitzungen für die App Engine-Anwendung verarbeitet.
Nachdem Sie session_set_save_handler
festgelegt haben, enthält jede Anfrage eine globale $_SESSION
-Variable, mit der Sie auf die Sitzung zugreifen können. Die Sitzungsdaten werden in Firestore gespeichert.
Lokal ausführen
Starten Sie den integrierten PHP-Webserver:
php -S localhost:8080
Sehen Sie sich die App in Ihrem Webbrowser an:
Cloud Shell
Klicken Sie in der Symbolleiste von Cloud Shell auf Webvorschau
und wählen Sie Vorschau auf Port 8080 aus.
Lokaler Computer
Rufen Sie im Browser
http://localhost:8080
auf.Eine dieser fünf Begrüßungen wird angezeigt: "Hello World", "Hallo Welt", "Hola mundo", "Salut le Monde" oder "Ciao Mondo". Die Sprache ändert sich, wenn Sie die Seite in einem anderen Browser oder im Inkognitomodus öffnen. Sie können die Sitzungsdaten in der Google Cloud Console ansehen und bearbeiten.
Drücken Sie im Terminalfenster
Control+C
, um den HTTP-Server zu beenden.
In App Engine bereitstellen und ausführen
Mit der App Engine-Standardumgebung können Sie eine Anwendung erstellen und bereitstellen, die zuverlässig unter hoher Last und mit großen Datenmengen ausgeführt wird.
In dieser Anleitung wird der Server mithilfe der App Engine-Standardumgebung bereitgestellt.
Erstellen Sie im Terminalfenster eine
app.yaml
-Datei und kopieren Sie Folgendes:Stellen Sie die Anwendung in App Engine bereit:
gcloud app deploy
Geben Sie die folgende URL ein, um die aktive Anwendung anzusehen:
https://PROJECT_ID.REGION_ID.r.appspot.com
Ersetzen Sie Folgendes:
PROJECT_ID
: Ihre Google Cloud-Projekt-IDREGION_ID
: Code, den App Engine Ihrer Anwendung zuweist
Die Begrüßung wird nun von einem Webserver bereitgestellt, der in einer App Engine-Instanz ausgeführt wird.
Sitzungen löschen
PHP führt die automatische Speicherbereinigung für Sitzungen aus. Dabei werden alte und abgelaufene Sitzungen gemäß Ihrer php.ini
-Konfiguration entfernt. Der Firestore-Sitzungs-Handler bereinigt Sitzungen standardmäßig nicht, aber Sie können ihn dazu konfigurieren. Hierfür übergeben Sie dem Sitzungs-Handler bei der Erstellung die Option gcLimit
:
Sitzungen werden mithilfe der auf Wahrscheinlichkeit basierenden automatischen Speicherbereinigung für Sitzungen entfernt oder wenn Sie die Funktion session_gc
explizit aufrufen.
Fehler in der Anwendung beheben
Wenn Sie keine Verbindung zu Ihrer App Engine-Anwendung herstellen können, prüfen Sie Folgendes:
- Überprüfen Sie, ob die
gcloud
-Bereitstellungsbefehle erfolgreich ausgeführt wurden und keine Fehler ausgegeben haben. Wenn Fehler wiemessage=Build failed
aufgetreten sind, beheben Sie diese und stellen Sie die App Engine-Anwendung noch einmal bereit. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.
Klicken Sie in der Drop-down-Liste Kürzlich ausgewählte Ressourcen auf App Engine-Anwendung und dann auf Alle Werte für module_id. Es wird eine Liste der Anfragen abgerufen, die Sie beim Besuch Ihrer Anwendung gestellt haben. Wenn keine Anfragenliste angezeigt wird, bestätigen Sie, dass Sie Alle Werte für module_id aus der Drop-down-Liste ausgewählt haben. Wenn Fehlermeldungen in der Google Cloud Console angezeigt werden, prüfen Sie, ob der Code Ihrer Anwendung mit dem Code im Abschnitt zum Schreiben der Webanwendung übereinstimmt.
Prüfen Sie, ob die Firestore API aktiviert ist.
Bereinigen
Projekt löschen
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
App Engine-Instanz löschen
- In the Google Cloud console, go to the Versions page for App Engine.
- Select the checkbox for the non-default app version that you want to delete.
- Klicken Sie zum Löschen der Anwendungsversion auf Löschen.