Die Google Cloud CLI enthält einen lokalen Entwicklungsserver (dev_appserver.py
). Sie können den lokalen Entwicklungsserver verwenden, um die Ausführung Ihrer Anwendung in der App Engine-Produktionsumgebung zu simulieren oder auf gebündelte App Engine-Dienste zuzugreifen.
Die simulierte Umgebung erzwingt gewisse Sandbox-Einschränkungen wie eingeschränkte Systemfunktionen und PHP 7+-Modulimporte. Andere Einschränkungen wie Anfragezeitüberschreitungen oder Kontingente werden hingegen nicht erzwungen.
Der lokale Entwicklungsserver simuliert außerdem die von den Bibliotheken im SDK für App Engine bereitgestellten Dienste, einschließlich Datenspeicher, Memcache und Aufgabenwarteschlangen. Hierzu werden die Aufgaben der Dienste vom Server lokal ausführt. Wenn die Anwendung auf dem Entwicklungsserver ausgeführt wird, können Sie weiterhin Remote API-Aufrufe über HTTP-Endpunkte von Google APIs an die Produktionsinfrastruktur senden.
Lokalen Entwicklungsserver ausführen
Nachdem Sie die Konfigurationsdatei app.yaml
für die Anwendung erstellt haben, können Sie mit dem Befehl dev_appserver.py
den lokalen Entwicklungsserver starten und die Anwendung lokal ausführen.
So starten Sie den lokalen Entwicklungsserver:
Lokalen Entwicklungsserver (dev_appserver.py
) ausführen
Der lokale Entwicklungsserver befindet sich unter [PATH_TO_CLOUD_SDK]/google-cloud-sdk/bin/dev_appserver.py
. Zum Ausführen des Tools können Sie entweder den vollständigen Pfad beim Ausführen von dev_appserver.py
angeben oder dev_appserver.py
zur Umgebungsvariable PATH
hinzufügen.
Wenn Sie die Tools der Google Cloud CLI Ihrem PATH
hinzufügen und die Befehlsvervollständigung aktivieren möchten, führen Sie den folgenden Befehl aus:
[PATH_TO_CLOUD_SDK]/google-cloud-sdk/install.sh
Führen Sie in dem Verzeichnis, das Ihre
app.yaml
-Konfigurationsdatei enthält, den Befehldev_appserver.py
aus. Wenn Python 2 nicht der Standard-Interpreter auf Ihrem System ist, müssen Siepython2 dev_appserver.py
ausführen, um sicherzustellen, dass der Python 2-Interpreter verwendet wird.Windows/macOS
Geben Sie den Verzeichnispfad zur Anwendung an. Beispiel:
dev_appserver.py [PATH_TO_YOUR_APP]
Alternativ können Sie die Konfigurationsdatei eines bestimmten Dienstes angeben. Beispiel:
dev_appserver.py app.yaml
Fügen Sie die Option
--port
ein, um den Port zu ändern:dev_appserver.py --port=9999 [PATH_TO_YOUR_APP]
Linux/benutzerdefinierte Version von php-cgi
Wenn Sie Linux verwenden oder eine benutzerdefinierte Version von
php-cgi
verwenden möchten, müssen Sie den Verzeichnispfad zuphp-cgi
angeben:Erstellen Sie auf einem lokalen Computer eine eigene Version der App Engine-PHP-Erweiterung.
Starten Sie den lokalen Entwicklungsserver mit den Optionen
--php_executable_path
und--php_gae_extension_path
:dev_appserver.py --php_executable_path=[PATH_TO_PHP_7_EXECUTABLE] --php_gae_extension_path=[PATH_TO_APPENGINE_EXTENSION] app.yaml
Dabei steht
--php_executable_path
für den Speicherort des von Ihnen verwendeten PHP-Interpreters und--php_gae_extension_path
für den Speicherort der Dateigae_runtime_module.so
, die Sie im vorherigen Schritt erstellt haben.
Funktioniert dev_appserver.py nicht?
Weitere Informationen zu
dev_appserver.py
-Befehlsoptionen finden Sie unter Optionen für lokalen Entwicklungsserver.Der lokale Entwicklungsserver wird jetzt ausgeführt und ist für Anfragen bereit. Rufen Sie http://localhost:8080/ in Ihrem Webbrowser auf, um die Anwendung in Aktion zu sehen.
Wenn Sie einen benutzerdefinierten Port mit der Option
--port
angegeben haben, müssen Sie den Port in Ihrem Browser öffnen.
Mit den folgenden Tastenkombinationen können Sie den lokalen Server über die Befehlszeile beenden:
- macOS oder Linux: Strg + C
- Windows: Strg + Pause
Anwendungs-IDs angeben
Verwenden Sie die Funktion zum Aufrufen der Anwendungs-ID auf dem lokalen Server, z. B. für das Spoofing einer E-Mail-Adresse. Verwenden Sie die Funktion, um den Hostnamen der ausgeführten Anwendung abzurufen.
Laufzeitumgebung der Anwendung erkennen
Ermitteln Sie den Wert der Umgebungsvariable SERVER_SOFTWARE
, um zu prüfen, ob der Code in einer Produktionsumgebung oder auf dem lokalen Entwicklungsserver ausgeführt wird.
if (strpos(getenv('SERVER_SOFTWARE'), 'Development') === 0){
echo 'Local development server';
} else {
echo 'Production';
}
Daten speichern
App Engine for PHP unterstützt das Lesen und Schreiben von Daten in Cloud Storage über die Streams API von PHP. Wenn Sie eine PHP-Funktion verwenden, die die Implementierung von PHP-Streams unterstützt, z. B. fopen, fwrite oder file_get_contents, geben Sie zum Lesen und Schreiben von Daten in Cloud Storage einen Cloud Storage-URI (gs://
) an.
Der lokale Entwicklungsserver emuliert diese Funktionalität, indem er in temporäre lokale Dateien schreibt und daraus liest, die zwischen Anfragen erhalten bleiben.
Lokalen Datenspeicher durchsuchen
Wenn die Anwendung mithilfe des lokalen Entwicklungsservers Daten in den lokalen Datenspeicher geschrieben hat, können Sie diese in der lokalen Entwicklungskonsole durchsuchen.
So durchsuchen Sie den lokalen Datenspeicher:
Rufen Sie in der lokalen Entwicklungskonsole den Datastore-Betrachter auf. Die URL lautet
http://localhost:8000/datastore
.Sehen Sie sich die Inhalte des lokalen Datenspeichers an.
Nutzerdienst verwenden
App Engine bietet einen Nutzerdienst, der die Authentifizierung und Autorisierung für Ihre Anwendung vereinfacht. Der lokale Entwicklungsserver simuliert das Verhalten von Google-Konten mit eigenen Anmelde- und Abmeldeseiten. Bei der Ausführung auf dem lokalen Entwicklungsserver geben die Funktionen createLoginURL
und createLogoutURL
URLs für /_ah/login
und /_ah/logout
auf dem lokalen Server zurück.
Mail-Dienst verwenden
Der lokale Entwicklungsserver kann einen SMTP-Server oder eine lokale Installation von Sendmail nutzen, um E-Mails für Aufrufe an den App Engine-E-Mail-Dienst zu senden.
SMTP verwenden
Zum Aktivieren der E-Mail-Unterstützung mit einem SMTP-Server rufen Sie dev_appserver.py
so auf:
dev_appserver.py --smtp_host=smtp.example.com --smtp_port=25 \
--smtp_user=ajohnson --smtp_password=k1tt3ns [PATH_TO_YOUR_APP]
Dabei geben Sie für die Optionen --smtp_host
, --smtp_port
, --smtp_user
und --smtp_password
eigene Werte an.
Sendmail verwenden
Zum Aktivieren der E-Mail-Unterstützung mit Sendmail rufen Sie dev_appserver.py
so auf:
dev_appserver.py --enable_sendmail=yes [PATH_TO_YOUR_APP]
Der lokale Server verwendet dann den Befehl sendmail
, um E-Mail-Nachrichten mit der Standardkonfiguration Ihrer Installation zu versenden.
URL Fetch verwenden
Wenn die Anwendung die URL Fetch API zum Erstellen einer HTTP-Anfrage verwendet, führt der lokale Entwicklungsserver die Anfrage direkt von Ihrem Computer aus. Das Verhalten von URL Fetch auf dem lokalen Server kann sich vom Verhalten in der App Engine-Produktionsumgebung unterscheiden, wenn Sie einen Proxyserver für den Zugriff auf Websites verwenden.
Lokale Fehlerbehebung mit XDebug
Wenn Sie einen Debugger haben, der mit dem XDebug-Debugger kompatibel ist, und das Modul xdebug
installiert ist, können Sie XDebug mit dem lokalen Entwicklungsserver verwenden.
So aktivieren Sie XDebug unter Linux oder macOS auf dem Entwicklungsserver:
Exportieren Sie die Umgebungsvariable
XDEBUG_CONFIG
mit einem IDE-Schlüssel (idekey), damit die IDE dazu eine Verbindung herstellen kann:export XDEBUG_CONFIG="idekey=netbeans-xdebug remote_host=localhost"
Entwicklungsserver mit
--php_remote_debugging=yes
aufrufen