Diffuser des images

L'API App Engine pour les outils Cloud Storage offre des méthodes pratiques pour diffuser les fichiers image :

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

Cette page explique comment utiliser les anciens services groupés et les anciennes API. Cette API ne peut s'exécuter que dans des environnements d'exécution de première génération dans l'environnement standard App Engine. Si vous effectuez une mise à jour vers l'environnement d'exécution PHP 7/8 d'App Engine, consultez le guide de migration pour en savoir plus sur les options de migration des anciens services groupés.

Remarque : Lorsque vous exécutez votre application localement sur le serveur de développement, vous devez installer PIL si vous souhaitez utiliser les options de dimensionnement des images décrites sur cette page.

L'un des avantages de cette méthode de diffusion d'images par rapport à la simple publication de fichiers est la possibilité de redimensionner et de recadrer les images de manière dynamique, sans avoir à les stocker dans différentes tailles.

CloudStorageTools::getImageServingUrl renvoie une URL de diffusion pour une image. Si l'image est affichée sur une page HTTPS, définissez secure_url sur True pour éviter les avertissements de contenus mixtes.

Sachez que cette URL est lisible publiquement, mais qu'elle ne peut pas être devinée.

Important : Vous ne pouvez pas diffuser une image à partir de deux applications distinctes. Seule la première application qui appelle getImageServingUrl peut obtenir l'URL pour la diffuser, car cette application détient la propriété de l'image et donc la capacité de la diffuser. Toute autre application qui appelle ensuite getImageServingUrl sur l'image ne parviendra donc pas à la diffuser. Si une seconde application doit diffuser l'image, elle doit d'abord la copier, puis appeler getImageServingUrl sur la copie.

Pour arrêter de diffuser l'URL, appelez CloudStorageTools::deleteImageServingUrl.

Remarque : Si vous souhaitez supprimer le fichier lui-même, utilisez la fonction PHP unlink().

Pour utiliser cette fonctionnalité, importez la classe CloudStorageTools :

use google\appengine\api\cloud_storage\CloudStorageTools;

Vous pouvez maintenant redimensionner et recadrer l'image image.jpg :

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