Generate query parameters information

Author: kitloong

src/Doc.php

@@ -325,6 +325,14 @@ public function setResponses(array $responses): void
         $this->responses = $responses;
     }
 
+    /**
+     * @return array<string, string>
+     */
+    public function getPathParameters(): array
+    {
+        return $this->pathParameters;
+    }
+
     public function clone(): Doc
     {
         return clone $this;

src/LaravelRequestDocsToOpenApi.php

@@ -34,17 +34,22 @@ private function docsToOpenApi(array $docs): void
     {
         $this->openApi['paths'] = [];
         foreach ($docs as $doc) {
-            $requestHasFile = false;
-            $httpMethod     = strtolower($doc->getHttpMethod());
-            $isGet          = $httpMethod == 'get';
-            $isPost         = $httpMethod == 'post';
-            $isPut          = $httpMethod == 'put';
-            $isDelete       = $httpMethod == 'delete';
-
-            $this->openApi['paths'][$doc->getUri()][$httpMethod]['description'] = $doc->getDocBlock();
-            $this->openApi['paths'][$doc->getUri()][$httpMethod]['parameters']  = [];
+            $requestHasFile  = false;
+            $httpMethod      = strtolower($doc->getHttpMethod());
+            $isGet           = $httpMethod == 'get';
+            $isPost          = $httpMethod == 'post';
+            $isPut           = $httpMethod == 'put';
+            $isDelete        = $httpMethod == 'delete';
+            $uriLeadingSlash = '/' . $doc->getUri();
+
+            $this->openApi['paths'][$uriLeadingSlash][$httpMethod]['description'] = $doc->getDocBlock();
+            $this->openApi['paths'][$uriLeadingSlash][$httpMethod]['parameters']  = [];
+
+            foreach ($doc->getPathParameters() as $parameter => $rule) {
+                $this->openApi['paths'][$uriLeadingSlash][$httpMethod]['parameters'][] = $this->makeQueryParameterItem($parameter, $rule);
+            }
 
-            $this->openApi['paths'][$doc->getUri()][$httpMethod]['responses'] = config('request-docs.open_api.responses', []);
+            $this->openApi['paths'][$uriLeadingSlash][$httpMethod]['responses'] = config('request-docs.open_api.responses', []);
 
             foreach ($doc->getRules() as $attribute => $rules) {
                 foreach ($rules as $rule) {
@@ -60,21 +65,18 @@ private function docsToOpenApi(array $docs): void
 
             $contentType = $requestHasFile ? 'multipart/form-data' : 'application/json';
 
-            if ($isGet) {
-                $this->openApi['paths'][$doc->getUri()][$httpMethod]['parameters'] = [];
-            }
             if ($isPost || $isPut || $isDelete) {
-                $this->openApi['paths'][$doc->getUri()][$httpMethod]['requestBody'] = $this->makeRequestBodyItem($contentType);
+                $this->openApi['paths'][$uriLeadingSlash][$httpMethod]['requestBody'] = $this->makeRequestBodyItem($contentType);
             }
 
             foreach ($doc->getRules() as $attribute => $rules) {
                 foreach ($rules as $rule) {
                     if ($isGet) {
-                        $parameter                                                           = $this->makeQueryParameterItem($attribute, $rule);
-                        $this->openApi['paths'][$doc->getUri()][$httpMethod]['parameters'][] = $parameter;
+                        $parameter                                                             = $this->makeQueryParameterItem($attribute, $rule);
+                        $this->openApi['paths'][$uriLeadingSlash][$httpMethod]['parameters'][] = $parameter;
                     }
                     if ($isPost || $isPut || $isDelete) {
-                        $this->openApi['paths'][$doc->getUri()][$httpMethod]['requestBody']['content'][$contentType]['schema']['properties'][$attribute] = $this->makeRequestBodyContentPropertyItem($rule);
+                        $this->openApi['paths'][$uriLeadingSlash][$httpMethod]['requestBody']['content'][$contentType]['schema']['properties'][$attribute] = $this->makeRequestBodyContentPropertyItem($rule);
                     }
                 }
             }