Setup

This API is supported for first-generation runtimes and can be used when upgrading to corresponding second-generation runtimes. If you are updating to the App Engine PHP 7/8 runtime, refer to the migration guide to learn about your migration options for legacy bundled services.

Your PHP 5 app requires a properly configured Google Cloud Storage bucket. Fortunately, each app can easily gain access to such a bucket if you do the following:

1. Enable billing for your project, if you haven't already done so.
2. Click Create bucket in the Storage Browser for your project.

Note you might incur costs by using a Cloud Storage bucket. Each project can have a default bucket, which includes 5GB of free storage and a free quota for I/O operations.

Useful tricks when using default buckets

When using a default bucket, you don't actually need to know your bucket name: you can use #default# and this will be replaced at runtime by the name of the default bucket.

Note: The default bucket name is typically <app_id>.appspot.com, where <app_id> is your app ID. You can find the bucket name in the App Engine Admin console Application Settings page, under the label Google Cloud Storage Bucket. Alternatively, if you don't want to use #default#, you can use the CloudStorageTools::getDefaultGoogleStorageBucketName() method to find the name programmatically.

For example, you would write to the default bucket using the App Engine stream wrapper for Cloud Storage:

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

or

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