設定

這個 API 支援第一代執行階段，並可在升級至對應的第二代執行階段時使用。 如要更新至 App Engine PHP 7/8 執行階段，請參閱遷移指南，瞭解舊版套裝組合服務的遷移選項。

您的 PHP 5 應用程式需要經過妥善設定的 Google Cloud Storage 值區。只要您執行下列步驟，每個應用程式就能輕鬆存取這類值區：

1. 針對您的專案啟用計費功能 (如果尚未啟用)。
2. 在專案的 Storage「Browser」(瀏覽器) 中按一下「Create bucket」(建立值區)。

請注意，使用 Cloud Storage 值區可能會產生費用。每個專案都可以有一個預設值區，這個值區包括 5GB 的免費儲存空間及免費的 I/O 作業配額。

使用預設值區的實用秘訣

使用預設值區時，您其實不需要知道值區名稱。您可以使用 #default#，而這個值會在執行階段中替換為預設值區的名稱。

注意： 預設 bucket 名稱通常是 <app_id>.appspot.com，其中 <app_id> 是您的應用程式 ID。如要查看 bucket 名稱，請開啟 App Engine 管理控制台的「Application Settings」(應用程式設定) 頁面，並前往「Google Cloud Storage Bucket」(Google Cloud Storage bucket) 標籤下方。如果您不想使用 #default#，可以改用 CloudStorageTools::getDefaultGoogleStorageBucketName() 方法，透過程式搜尋值區名稱。

舉例來說，您可以使用 Cloud Storage 適用的 App Engine 串流包裝函式寫入預設值區：

$default_bucket = CloudStorageTools::getDefaultGoogleStorageBucketName();
file_put_contents("gs://${default_bucket}/hello_default.txt", $newFileContent);

或

$default_bucket = CloudStorageTools::getDefaultGoogleStorageBucketName();
$fp = fopen("gs://${default_bucket}/hello_default_stream.txt", 'w');
fwrite($fp, $newFileContent);
fclose($fp);