custom params for some controller methods

Author: Mdhesari

src/LaravelRequestDocs.php

@@ -112,6 +112,7 @@ public function appendRequestRules(array $controllersInfo)
             $method           = $controllerInfo['method'];
             $reflectionMethod = new ReflectionMethod($controller, $method);
             $params           = $reflectionMethod->getParameters();
+            $customRules = $this->customParamsDocComment($reflectionMethod->getDocComment());
 
             foreach ($params as $param) {
                 if (!$param->getType()) {
@@ -141,6 +142,11 @@ public function appendRequestRules(array $controllersInfo)
                     }
                     $controllersInfo[$index]['docBlock'] = $this->lrdDocComment($reflectionMethod->getDocComment());
                 }
+
+                $controllersInfo[$index]['rules'] = array_merge(
+                    $controllersInfo[$index]['rules'] ?? [],
+                    $customRules,
+                );
             }
         }
         return $controllersInfo;
@@ -231,4 +237,23 @@ public function rulesByRegex($requestClassName)
 
         return $rules;
     }
+
+    private function customParamsDocComment($docComment): array
+    {
+        $params = [];
+
+        foreach (explode("\n", $docComment) as $comment) {
+            if ( Str::contains($comment, '@QAparam') ) {
+                $comment = trim(Str::replace(['@QAparam', '*'], '', $comment));
+
+                $comment = explode(' ', $comment);
+
+                if (count($comment) > 0) {
+                    $params[$comment[0]] = array_values(array_filter($comment, fn($item) => $item != $comment[0]));
+                }
+            }
+        }
+
+        return $params;
+    }
 }