Expose the request context in the FPM layer via a global variable

src/Runtime/PhpFpm.php

@@ -173,6 +173,7 @@ private function isReady(): bool
     private function eventToFastCgiRequest(array $event): ProvidesRequestData
     {
         $requestBody = $event['body'] ?? '';
+
         if ($event['isBase64Encoded'] ?? false) {
             $requestBody = base64_decode($requestBody);
         }
@@ -209,7 +210,9 @@ private function eventToFastCgiRequest(array $event): ProvidesRequestData
         $request->setServerPort((int) ($headers['x-forwarded-port'][0] ?? 80));
         $request->setCustomVar('PATH_INFO', $event['path'] ?? '/');
         $request->setCustomVar('QUERY_STRING', $queryString);
-
+        if ($event['requestContext'] ?? false) {
+            $this->setArrayValue('REQUEST_CONTEXT', $event['requestContext'], $request);
+        }
         // See https://stackoverflow.com/a/5519834/245552
         if (! empty($requestBody) && $method !== 'TRACE' && ! isset($headers['content-type'])) {
             $headers['content-type'] = ['application/x-www-form-urlencoded'];
@@ -355,4 +358,24 @@ private function getResponseHeaders(ProvidesResponseData $response, bool $isMult
 
         return array_change_key_case($responseHeaders, CASE_LOWER);
     }
+
+    /**
+     * Recursively loop through a data object and create env variables
+     */
+    private function setArrayValue(string $name, array $array, FastCgiRequest $request): void
+    {
+        if (! is_array($array)) {
+            $request->setCustomVar(strtoupper($name), $array);
+        }
+
+        foreach ($array as $key => $value) {
+            if (! is_array($value)) {
+                $request->setCustomVar(strtoupper($name . '_' . $key), $value);
+            }
+
+            if (is_array($value)) {
+                $this->setArrayValue(strtoupper($name . '_' . $key), $value, $request);
+            }
+        }
+    }
 }

tests/Runtime/PhpFpmTest.php

@@ -41,6 +41,7 @@ public function test simple request()
                 'QUERY_STRING' => '',
                 'CONTENT_LENGTH' => '0',
                 'CONTENT_TYPE' => 'application/x-www-form-urlencoded',
+                'REQUEST_CONTEXT_PROTOCOL' => 'HTTP/1.1',
             ],
             'HTTP_RAW_BODY' => '',
         ]);
@@ -118,6 +119,56 @@ public function test request with multivalues query string have basic su
         ]);
     }
 
+    public function test request with requestContext array support()
+    {
+        $event = [
+            'httpMethod' => 'GET',
+            'path' => '/hello',
+            // See https://aws.amazon.com/blogs/compute/support-for-multi-value-parameters-in-amazon-api-gateway/
+            'multiValueQueryStringParameters' => [
+                'foo' => ['bar', 'baz'],
+            ],
+            'queryStringParameters' => [
+                'foo' => 'baz', // the 2nd value is preserved only by API Gateway
+            ],
+            'requestContext' => [
+                'foo' => 'baz',
+                'baz' => 'far',
+                'data' => [
+                    'recurse1' => 1,
+                    'recurse2' => 2,
+                ],
+            ],
+        ];
+        $this->assertGlobalVariables($event, [
+            '$_GET' => [
+                // TODO The feature is not implemented yet
+                'foo' => 'bar',
+            ],
+            '$_POST' => [],
+            '$_FILES' => [],
+            '$_COOKIE' => [],
+            '$_REQUEST' => [
+                'foo' => 'bar',
+            ],
+            '$_SERVER' => [
+                'REQUEST_URI' => '/hello?foo=bar',
+                'PHP_SELF' => '/hello',
+                'PATH_INFO' => '/hello',
+                'REQUEST_METHOD' => 'GET',
+                'QUERY_STRING' => 'foo=bar',
+                'CONTENT_LENGTH' => '0',
+                'CONTENT_TYPE' => 'application/x-www-form-urlencoded',
+                'REQUEST_CONTEXT_FOO' => 'baz',
+                'REQUEST_CONTEXT_BAZ' => 'far',
+                'REQUEST_CONTEXT_DATA_RECURSE1' => 1,
+                'REQUEST_CONTEXT_DATA_RECURSE2' => 2,
+            ],
+            'HTTP_RAW_BODY' => '',
+
+        ]);
+    }
+
     public function test request with arrays in query string()
     {
         $event = [