Add warning for missing argument types in stubs

Author: kocsismate

build/gen_stub.php

@@ -576,8 +576,19 @@ public function getValue(): string {
 
     public function getVariableName(): string {
         $value = $this->getValue();
-        if ($value === null || strlen($value) === 0 || $value[0] !== '$') {
-            throw new Exception("@$this->name not followed by variable name");
+        if ($value === null || strlen($value) === 0) {
+            throw new Exception("@$this->name doesn't have any value");
+        }
+
+        if ($this->name === "param") {
+            $pos = strpos($value, " ");
+            if ($pos !== false) {
+                $value = substr($value, $pos + 1);
+            }
+        }
+
+        if ($value[0] !== '$') {
+            throw new Exception("@$this->name doesn't contain variable name");
         }
 
         return substr($value, 1);
@@ -610,6 +621,7 @@ function parseFunctionLike(
     $alias = null;
     $isDeprecated = false;
     $haveDocReturnType = false;
+    $docParamTypes = [];
 
     if ($comment) {
         $tags = parseDocComment($comment);
@@ -631,13 +643,16 @@ function parseFunctionLike(
                 $isDeprecated = true;
             } else if ($tag->name === 'return') {
                 $haveDocReturnType = true;
+            } else if ($tag->name === 'param') {
+                $docParamTypes[$tag->getVariableName()] = true;
             }
         }
     }
 
     $args = [];
     $numRequiredArgs = 0;
     $foundVariadic = false;
+    $hasParameterWarning = false;
     foreach ($func->getParams() as $i => $param) {
         $varName = $param->var->name;
         $preferRef = !empty($paramMeta[$varName]['preferRef']);
@@ -656,6 +671,12 @@ function parseFunctionLike(
         }
 
         $type = $param->type ? Type::fromNode($param->type) : null;
+        if ($type === null && !isset($docParamTypes[$varName]) && !$hasParameterWarning) {
+            $hasParameterWarning = true;
+            //throw new Exception("Missing argument type for function $name()");
+            echo "Warning: Missing argument type for function $name()\n";
+        }
+
         if ($param->default instanceof Expr\ConstFetch &&
             $param->default->name->toLowerString() === "null" &&
             $type && !$type->isNullable()