Préparation

Cette API est compatible avec les environnements d'exécution de première génération et peut être utilisée lors de la mise à niveau vers des environnements d'exécution de deuxième génération correspondants. Si vous effectuez une mise à jour vers l'environnement d'exécution PHP 7/8 d'App Engine, consultez le guide de migration pour en savoir plus sur les options de migration des anciens services groupés.

Votre application PHP 5 nécessite un bucket Google Cloud Storage correctement configuré. Heureusement, chaque application peut facilement accéder à ce type de bucket si vous procédez comme suit :

1. Activez la facturation pour votre projet, si ce n'est pas déjà fait.
2. Cliquez sur Créer un bucket dans le navigateur Storage du projet.

Notez que vous pouvez encourir des frais en utilisant un bucket Cloud Storage. Chaque projet peut être associé à un bucket par défaut, qui inclut 5 Go d'espace de stockage gratuit et un quota gratuit pour les opérations d'E/S.

Astuces lors de l'utilisation de buckets par défaut

Lorsque vous utilisez un bucket par défaut, vous n'avez pas besoin de connaître son nom : vous pouvez utiliser #default#, qui sera remplacé au moment de l'exécution par le nom du bucket par défaut.

Remarque : Le nom du bucket par défaut est généralement <app_id>.appspot.com, où <app_id> correspond à l'identifiant de votre application. Vous pouvez trouver le nom du bucket sur la page Paramètres des applications de la console d'administration App Engine, sous le libellé Bucket Google Cloud Storage. Si vous ne souhaitez pas utiliser #default#, vous pouvez utiliser la méthode CloudStorageTools::getDefaultGoogleStorageBucketName() pour rechercher le nom de manière automatisée.

Par exemple, vous écririez dans le bucket par défaut à l'aide du wrapper de flux App Engine pour Cloud Storage :

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

ou

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