[Fix] Docblock::tag(...) throws TypeError (#753)

ExeQue · web-flow · commit 60af51979de6 · 2023-01-23T11:09:40.000-05:00
the `Docblock::tag(...)` method throws a TypeError when specifying a non-existent tag.
diff --git a/src/Util/Docblock.php b/src/Util/Docblock.php
@@ -212,10 +212,12 @@ public function hasTag(string $tag): bool
      *
      * @param string $tag
      *
-     * @return array
+     * @return array|null
      */
-    public function tag(string $tag): array
+    public function tag(string $tag)
     {
+        // TODO: Add proper null-type return values once the lowest PHP version supported is 7.1
+
         return $this->hasTag($tag) ? $this->tags[$tag] : null;
     }
 

Original file line number	Diff line number	Diff line change
`@@ -212,10 +212,12 @@ public function hasTag(string $tag): bool`
`212`	`212`	`*`
`213`	`213`	`* @param string $tag`
`214`	`214`	`*`
`215`		`- * @return array`
	`215`	`+ * @return array\|null`
`216`	`216`	`*/`
`217`		`- public function tag(string $tag): array`
	`217`	`+ public function tag(string $tag)`
`218`	`218`	`{`
	`219`	`+ // TODO: Add proper null-type return values once the lowest PHP version supported is 7.1`
	`220`	`+`
`219`	`221`	`return $this->hasTag($tag) ? $this->tags[$tag] : null;`
`220`	`222`	`}`
`221`	`223`