update some for doc parse

Author: inhere

src/Util/PhpDoc.php

@@ -11,7 +11,6 @@
 
 use function array_merge;
 use function in_array;
-use function is_array;
 use function preg_match;
 use function preg_replace;
 use function preg_split;
@@ -28,6 +27,17 @@
  */
 class PhpDoc
 {
+    /**
+     * @param string $doc
+     * @param array $options
+     *
+     * @return array
+     */
+    public static function getTags(string $doc, array $options = []): array
+    {
+        return self::parseDocs($doc, $options);
+    }
+
     /**
      * 以下三个方法来自 yii2 console/Controller.php 做了一些调整
      */
@@ -46,7 +56,7 @@ class PhpDoc
      *
      * @return array The parsed tags
      */
-    public static function getTags(string $comment, array $options = []): array
+    public static function parseDocs(string $comment, array $options = []): array
     {
         if (!$comment = trim($comment, "/ \n")) {
             return [];
@@ -86,12 +96,11 @@ public static function getTags(string $comment, array $options = []): array
                     continue;
                 }
 
-                if (!isset($tags[$name])) {
-                    $tags[$name] = trim($matches[2]);
-                } elseif (is_array($tags[$name])) {
+                // allow multi tag
+                if ($multi && in_array($name, $multi, true)) {
                     $tags[$name][] = trim($matches[2]);
                 } else {
-                    $tags[$name] = [$tags[$name], trim($matches[2])];
+                    $tags[$name] = trim($matches[2]);
                 }
             }
         }

test/Util/PhpDocTest.php

@@ -5,7 +5,6 @@
 use PHPUnit\Framework\TestCase;
 use ReflectionMethod;
 use Toolkit\Stdlib\Util\PhpDoc;
-use function vdump;
 
 /**
  * class PhpDocTest