Entrega imágenes

La API de App Engine para herramientas de Cloud Storage proporciona los siguientes métodos útiles a fin de entregar archivos de imagen:

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

En esta página, se describe cómo usar las API y los servicios agrupados en paquetes heredados. Esta API solo puede ejecutarse en entornos de ejecución de primera generación en el entorno estándar de App Engine. Si actualizas al entorno de ejecución de PHP 7/8 de App Engine, consulta la guía de migración para obtener información sobre tus opciones de migración para servicios agrupados en paquetes heredados.

Nota: Cuando ejecutes la app de forma local en el servidor de desarrollo, deberás instalar PIL si deseas usar las opciones de tamaño de la imagen que se describen en esta página.

Una ventaja de usar este método para entregar imágenes en lugar de solo hacer los archivos públicos es la posibilidad de cambiar el tamaño y recortar de forma dinámica, sin tener que almacenar las imágenes en tamaños diferentes.

CloudStorageTools::getImageServingUrl muestra una URL de entrega para una imagen. Si la imagen se mostrará en una página HTTPS, establece secure_url en True para evitar las advertencias de contenido mixto.

Ten en cuenta que esta URL puede ser leída por todos de forma pública, pero no es “adivinable”.

Importante: No puedes entregar una imagen desde dos apps distintas. Solo la primera app que llama a getImageServingUrl puede obtener la URL para entregarla, ya que esa app obtuvo la propiedad de la imagen. Por lo tanto, cualquier otra app que llame a getImageServingUrl en la imagen no la obtendrá. Si una segunda app necesita entregar la imagen, primero debe copiarla y, luego, invocar a getImageServingUrl en la copia.

Para detener la entrega de la URL, llama a CloudStorageTools::deleteImageServingUrl.

Nota: Si deseas borrar el archivo en sí, usa la función unlink() de PHP.

Para usar esta función, importa la clase CloudStorageTools:

use google\appengine\api\cloud_storage\CloudStorageTools;

Ahora cambia el tamaño y recorta la imagen image.jpg:

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