Bilder bereitstellen

Die App Engine API für Cloud Storage-Tools enthält praktische Methoden für die Bereitstellung von Bilddateien:

• CloudStorageTools.getImageServingUrl()
• CloudStorageTools.deleteImageServingUrl()

Auf dieser Seite wird beschrieben, wie Sie die gebündelten Legacy-Dienste und APIs verwenden. Diese API kann nur in Laufzeiten der ersten Generation in der App Engine-Standardumgebung ausgeführt werden. Wenn Sie die App Engine PHP 7/8-Laufzeit aktualisieren, lesen Sie die Migrationsanleitung, um mehr über Ihre Migrationsoptionen für gebündelte Legacy-Dienste zu erfahren.

Hinweis: Wenn Sie die Anwendung lokal auf demEntwicklungsserver ausführen und die auf dieser Seite beschriebenen Optionen zur Anpassung der Bildgröße verwenden möchten, müssen Sie PIL installieren

Nutzen Sie diese Methode zur Bereitstellung von Bildern, anstatt einfach die Dateien zu veröffentlichen. Denn mit dieser Methode können Sie die Bildgröße dynamisch ändern und Bilder zuschneiden, ohne sie in verschiedenen Größen speichern zu müssen.

Die Methode CloudStorageTools::getImageServingUrl gibt eine URL zurück, mit der Sie das Bild bereitstellen können. Wenn Sie das Bild auf einer HTTPS-Seite anzeigen lassen möchten, setzen Sie secure_url auf True. So vermeiden Sie Warnungen vor gemischten Inhalten.

Beachten Sie, dass diese URL für alle öffentlich zugänglich ist, aber nicht "erraten" werden kann.

Wichtig: Sie können ein Bild nicht aus zwei separaten Anwendungen bereitstellen. Nur die erste Anwendung, die getImageServingUrl aufruft, erhält die URL für die Bereitstellung. Sie hat sozusagen die Inhaberschaft für die Bildbereitstellung. Der Aufruf von getImageServingUrl für das Bild durch jede weitere Anwendung bleibt ohne Erfolg. Wenn es erforderlich ist, dass eine zweite Anwendung das Bild bereitstellt, muss diese Anwendung das Bild zuerst kopieren und dann getImageServingUrl für die Kopie aufgerufen.

Zum Beenden der URL-Bereitstellung rufen Sie die Methode CloudStorageTools::deleteImageServingUrl auf.

Hinweis: Zum Löschen der Datei verwenden Sie die PHP-Funktion unlink().

Damit dieses Feature verfügbar ist, müssen Sie die Klasse CloudStorageTools importieren:

use google\appengine\api\cloud_storage\CloudStorageTools;

Sie können nun die Größe des Bildes image.jpg ändern und das Bild zuschneiden:

$options = ['size' => 400, 'crop' => true];
$image_file = "gs://${my_bucket}/image.jpg";
$image_url = CloudStorageTools::getImageServingUrl($image_file, $options);