feat: add query handling methods to Request class

Author: chinfuyang

src/http-client/src/Request.php

@@ -198,6 +198,22 @@ public function withData(array $data): Request
         return $this;
     }
 
+    public function query(): array
+    {
+        parse_str($this->request->getUri()->getQuery(), $query);
+
+        return $query;
+    }
+
+    public function withQuery(array $query = []): Request
+    {
+        $new = $this->request->getUri()->withQuery(http_build_query(array_merge($this->query(), $query)));
+
+        $this->request = $this->request->withUri($new);
+
+        return $this;
+    }
+
     /**
      * Get the underlying PSR compliant request instance.
      */

tests/ApiClient/ApiRequestTest.php

@@ -176,4 +176,11 @@ public function testWithUserAgent(): void
 
         $this->assertSame([$userAgent], $request->toPsrRequest()->getHeader('User-Agent'));
     }
+
+    public function testWithQuery(): void
+    {
+        $request = $this->request->withQuery(['param1' => 'value1', 'param2' => 'value2']);
+
+        $this->assertSame('param1=value1&param2=value2', $request->toPsrRequest()->getUri()->getQuery());
+    }
 }