converter: normalize commonly used aliases

Author: mfn

src/Converter.php

@@ -459,10 +459,10 @@ private function getReturn(Project $project, int $objectType, string $namespace
     }
 
     /**
-     * Gets the parameter type and applies a whitelist of PHPs supported types
+     * Gets the parameter type and tries to find best-matching PHP type
      *
-     * The whitelist is only applied for all-lowercase character; everything
-     * else is considered to be a class name.
+     * Commonly used type aliases are normalized and a whitelist for
+     * all-lowercase types is applied.
      *
      * @param Tag $tag
      *
@@ -479,6 +479,7 @@ private function getType(Tag $tag): array
         $typeDesc = $type[0];
 
         if ($typeDesc === strtolower($typeDesc)) {
+            $typeDesc = $this->normalizeType($typeDesc);
             // match all-lowercase types against known types
             if (!in_array($typeDesc, static::TYPES)) {
                 return [];
@@ -560,4 +561,35 @@ private function endsInNewLine(string $output): string
 
         return $matches[1];
     }
+
+     /**
+     * Normalizes the type.
+     *
+     * @link https://github.com/symfony/symfony/blob/d2d8d17a8068d76f42c42c7791f45ca68f4f98a4/src/Symfony/Component/PropertyInfo/Extractor/PhpDocExtractor.php#L317-L346
+     * @license https://github.com/symfony/symfony/blob/d2d8d17a8068d76f42c42c7791f45ca68f4f98a4/src/Symfony/Component/PropertyInfo/LICENSE
+     *
+     * @param string $docType
+     *
+     * @return string
+     */
+    private function normalizeType($docType)
+    {
+        switch ($docType) {
+            case 'integer':
+                return 'int';
+
+            case 'boolean':
+                return 'bool';
+
+            // real is not part of the PHPDoc standard, so we ignore it
+            case 'double':
+                return 'float';
+
+            case 'callback':
+                return 'callable';
+
+            default:
+                return $docType;
+        }
+    }
 }