提供圖片

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);