unannotated path params are now handled properly

Author: eceltov

app/helpers/Swagger/AnnotationHelper.php

@@ -126,6 +126,8 @@ private static function extractStandardAnnotationParams(array $annotations, stri
     {
         $routeParams = self::getRoutePathParamNames($route);
 
+        ///TODO: there can be unannotated query params as well
+
         $params = [];
         foreach ($annotations as $annotation) {
             // assumed that all query parameters have a @param annotation
@@ -144,6 +146,9 @@ private static function extractStandardAnnotationParams(array $annotations, stri
                 if (in_array($name, $routeParams)) {
                     $location = 'path';
                     $isPathParam = true;
+                    // remove the path param from the path param list to detect parameters left behind
+                    // (this happens when the path param does not have an annotation line)
+                    unset($routeParams[array_search($name, $routeParams)]);
                 }
 
                 $swaggerType = self::getSwaggerType($annotationType);
@@ -164,6 +169,21 @@ private static function extractStandardAnnotationParams(array $annotations, stri
                 $params[] = $descriptor;
             }
         }
+
+        // handle path params without annotations
+        foreach ($routeParams as $pathParam) {
+            $descriptor = new AnnotationParameterData(
+                // some type needs to be assigned and string seems reasonable for a param without any info
+                "string",
+                $pathParam,
+                null,
+                "path",
+                true,
+                false,
+            );
+            $params[] = $descriptor;
+        }
+
         return $params;
     }