refactor(functions): declarative function signature for helloworld_storage (GoogleCloudPlatform#1555)

Author: anniefu

functions/helloworld_storage/SampleUnitTest.php

@@ -1,4 +1,5 @@
 
+
 /**
  * Copyright 2020 Google LLC.
  *
@@ -21,7 +22,9 @@
 
 namespace Google\Cloud\Samples\Functions\HelloworldStorage\Test;
 
-use Google\CloudFunctions\CloudEvent;
+use CloudEvents\V1\CloudEventImmutable;
+use CloudEvents\V1\CloudEventInterface;
+
 use PHPUnit\Framework\TestCase;
 
 /**
@@ -45,19 +48,18 @@ public function dataProvider()
     {
         return [
             [
-                'cloudevent' => CloudEvent::fromArray([
-                    'id' => uniqid(),
-                    'source' => 'storage.googleapis.com',
-                    'specversion' => '1.0',
-                    'type' => 'google.cloud.storage.object.v1.finalized',
-                    'data' => [
+                'cloudevent' => new CloudEventImmutable(
+                    uniqId(), // id
+                    'storage.googleapis.com', // source
+                    'google.cloud.storage.object.v1.finalized', // type
+                    [
                         'bucket' => 'some-bucket',
                         'metageneration' => '1',
                         'name' => 'folder/friendly.txt',
                         'timeCreated' => '2020-04-23T07:38:57.230Z',
                         'updated' => '2020-04-23T07:38:57.230Z',
-                    ],
-                ]),
+                    ] // data
+                ),
                 'statusCode' => '200',
             ],
         ];
@@ -66,7 +68,7 @@ public function dataProvider()
     /**
      * @dataProvider dataProvider
      */
-    public function testFunction(CloudEvent $cloudevent, string $statusCode): void
+    public function testFunction(CloudEventInterface $cloudevent): void
     {
         // Capture function output by overriding the function's logging behavior.
         // The 'LOGGER_OUTPUT' environment variable must be used in your function:

functions/helloworld_storage/composer.json

@@ -1,6 +1,7 @@
 {
     "require": {
-        "google/cloud-functions-framework": "^1.0.0"
+        "php": ">= 7.4",
+        "google/cloud-functions-framework": "^1.1"
     },
     "scripts": {
         "start": [

functions/helloworld_storage/index.php

@@ -1,4 +1,5 @@
 
+
 /**
  * Copyright 2020 Google LLC.
  *
@@ -17,9 +18,16 @@
 
 // [START functions_helloworld_storage]
 
-use Google\CloudFunctions\CloudEvent;
+use CloudEvents\V1\CloudEventInterface;
+use Google\CloudFunctions\FunctionsFramework;
+
+// Register the function with Functions Framework.
+// This enables omitting the `FUNCTIONS_SIGNATURE_TYPE=cloudevent` environment
+// variable when deploying. The `FUNCTION_TARGET` environment variable should
+// match the first parameter.
+FunctionsFramework::cloudEvent('helloGCS', 'helloGCS');
 
-function helloGCS(CloudEvent $cloudevent)
+function helloGCS(CloudEventInterface $cloudevent)
 {
     $log = fopen(getenv('LOGGER_OUTPUT') ?: 'php://stderr', 'wb');
     $data = $cloudevent->getData();