nested array syntax for body param

Author: mtrajano

src/Parameters/BodyParameterGenerator.php

@@ -29,21 +29,13 @@ public function getParameters()
 
         foreach ($this->rules as $param => $rule) {
             $paramRules = $this->splitRules($rule);
-            $enums = $this->getEnumValues($paramRules);
+            $nameTokens = explode('.', $param);
+
+            $this->addToProperties($properties, $nameTokens, $paramRules);
 
             if ($this->isParamRequired($paramRules)) {
                 $required[] = $param;
             }
-
-            $propObj = [
-                'type' => $this->getParamType($paramRules)
-            ];
-
-            if (!empty($enums)) {
-                $propObj['enum'] = $enums;
-            }
-
-            $properties[$param] = $propObj;
         }
 
         if (!empty($required)) {
@@ -59,4 +51,47 @@ public function getParamLocation()
     {
         return 'body';
     }
+
+    protected function addToProperties(&$properties, $nameTokens, $rules)
+    {
+        if (empty($nameTokens)) {
+            return;
+        }
+
+        $name = array_shift($nameTokens);
+
+        if (!empty($nameTokens)) {
+            $type = $this->getNestedParamType($nameTokens);
+        } else {
+            $type = $this->getParamType($rules);
+        }
+
+        $propObj = [
+            'type' => $type
+        ];
+
+        if ($enums = $this->getEnumValues($rules)) {
+            $propObj['enum'] = $enums;
+        }
+
+        if ($name === '*') {
+            $name = 0;
+        }
+
+        $properties[$name] = $propObj;
+
+        if ($type === 'array') {
+            $properties[$name]['items'] = [];
+            $this->addToProperties($properties[$name]['items'], $nameTokens, $rules);
+        }
+    }
+
+    protected function getNestedParamType($nameTokens)
+    {
+        if (current($nameTokens) === '*') {
+            return 'array';
+        } else {
+            return 'object';
+        }
+    }
 }

tests/Parameters/BodyParameterGeneratorTest.php

@@ -76,6 +76,31 @@ public function testEnumInBody()
         ], $bodyParameters['schema']['properties']);
     }
 
+    public function testArraySyntax()
+    {
+        $bodyParameters = $this->getBodyParameters([
+            'matrix' => 'array',
+            'matrix.*' => 'array',
+            'matrix.*.*' => 'integer',
+        ]);
+
+        $this->assertEquals([
+            'matrix' => [
+                'type' => 'array',
+                'items' => [
+                    [
+                        'type' => 'array',
+                        'items' => [
+                            [
+                                'type' => 'integer'
+                            ]
+                        ]
+                    ]
+                ]
+            ]
+        ], $bodyParameters['schema']['properties']);
+    }
+
     private function getBodyParameters(array $rules)
     {
         $bodyParameters = (new BodyParameterGenerator($rules))->getParameters();