传送图片

适用于 Cloud Storage 工具的 App Engine API 为传送图片文件提供了简便方法：

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

本页面介绍如何使用旧版捆绑服务及其 API。此 API 只能在 App Engine 标准环境的第一代运行时中运行。如果要更新到 App Engine PHP 7/8 运行时，请参阅迁移指南以了解旧版捆绑服务的迁移选项。

注意：当您在本地开发服务器上运行应用时，如果想要使用本页面介绍的图片大小调整选项，则需要安装 PIL。

与将文件设置为公开相比，通过这种方法传送图片的一个优点是可以动态调整大小和进行剪裁，无需存储不同大小的图片。

CloudStorageTools::getImageServingUrl 可返回图片的传送网址。如果图片将在 HTTPS 网页中展示，请将 secure_url 设置为 True，以免出现混合内容警告。

请注意，此网址可公开供所有人读取，但它“不可猜测”。

重要提示：您无法从两个不同的应用传送同一张图片；仅第一个调用 getImageServingUrl 的应用可以获取网址进行传送，因为该应用已获取传送图片所需的图片所有权。因此，其他任何应用都无法再成功对该图片调用 getImageServingUrl。如果第二个应用需要传送图片，则此应用需要先复制该图片，然后对副本调用 getImageServingUrl。

如需停止传送网址，请调用 CloudStorageTools::deleteImageServingUrl。

注意：如果您要删除文件本身，请使用 PHP unlink() 函数。

如需使用此功能，请导入 CloudStorageTools 类：

use google\appengine\api\cloud_storage\CloudStorageTools;

现在，调整图片 image.jpg 的大小并进行剪裁：

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