feat(Datastore): Add support for the ExplainOptions (#8361)

Author: Hectorhammett

Core/src/GrpcTrait.php

@@ -313,6 +313,20 @@ private function formatDurationForApi($value)
         ];
     }
 
+    /**
+     * Format a duration from the API
+     *
+     * @param array $value
+     * @return string
+     */
+    private function formatDurationFromApi($value): string
+    {
+        $seconds = $value['seconds'];
+        $nanos = str_pad($value['nanos'], 9, 0, STR_PAD_LEFT);
+
+        return "{$seconds}.{$nanos}s";
+    }
+
     /**
      * Construct a gapic client. Allows for tests to intercept.
      *

Datastore/composer.json

@@ -5,7 +5,7 @@
     "minimum-stability": "stable",
     "require": {
         "php": "^8.0",
-        "google/cloud-core": "^1.57",
+        "google/cloud-core": "^1.63.0",
         "google/gax": "^1.36.0"
     },
     "require-dev": {

Datastore/src/Connection/Grpc.php

@@ -76,6 +76,9 @@ public function __construct(array $config = [])
             },
             'google.protobuf.Timestamp' => function ($v) {
                 return $this->formatTimestampFromApi($v);
+            },
+            'google.protobuf.Duration' => function ($v) {
+                return $this->formatDurationFromApi($v);
             }
         ], [], [
             'google.protobuf.Timestamp' => function ($v) {

Datastore/src/Connection/Rest.php

@@ -116,6 +116,13 @@ public function rollback(array $args)
      */
     public function runQuery(array $args)
     {
+        // There is a push to stop using generic arrays for options.
+        // We will transition into using structured options in the future
+        // hence we add this to handle options with the message type
+        if (isset($args['explainOptions'])) {
+            $args['explainOptions'] = json_decode($args['explainOptions']->serializeToJsonString());
+        }
+
         return $this->sendWithHeaders('projects', 'runQuery', $args);
     }
 
@@ -135,6 +142,12 @@ public function runAggregationQuery(array $args)
                 );
             }
         }
+        // There is a push to stop using generic arrays for options.
+        // We will transition into using structured options in the future
+        // hence we add this to handle options with the message type
+        if (isset($args['explainOptions'])) {
+            $args['explainOptions'] = json_decode($args['explainOptions']->serializeToJsonString());
+        }
         return $this->sendWithHeaders('projects', 'runAggregationQuery', $args);
     }