add support for @throws tag value parsing

Author: JanTvrdik

src/Ast/PhpDoc/ThrowsTagValueNode.php

@@ -0,0 +1,28 @@
+<?php declare(strict_types = 1);
+
+namespace PHPStan\PhpDocParser\Ast\PhpDoc;
+
+use PHPStan\PhpDocParser\Ast\Type\TypeNode;
+
+class ThrowsTagValueNode implements PhpDocTagValueNode
+{
+
+	/** @var TypeNode */
+	public $type;
+
+	/** @var string (may be empty) */
+	public $description;
+
+	public function __construct(TypeNode $type, string $description)
+	{
+		$this->type = $type;
+		$this->description = $description;
+	}
+
+
+	public function __toString(): string
+	{
+		return trim("{$this->type} {$this->description}");
+	}
+
+}

src/Parser/PhpDocParser.php

@@ -96,6 +96,10 @@ private function parseTagValue(TokenIterator $tokens, string $tag): Ast\PhpDoc\P
 					$tagValue = $this->parseReturnTagValue($tokens);
 					break;
 
+				case '@throws':
+					$tagValue = $this->parseThrowsTagValue($tokens);
+					break;
+
 				case '@property':
 				case '@property-read':
 				case '@property-write':
@@ -149,6 +153,14 @@ private function parseReturnTagValue(TokenIterator $tokens): Ast\PhpDoc\ReturnTa
 	}
 
 
+	private function parseThrowsTagValue(TokenIterator $tokens): Ast\PhpDoc\ThrowsTagValueNode
+	{
+		$type = $this->typeParser->parse($tokens);
+		$description = $this->parseOptionalDescription($tokens, true);
+		return new Ast\PhpDoc\ThrowsTagValueNode($type, $description);
+	}
+
+
 	private function parsePropertyTagValue(TokenIterator $tokens): Ast\PhpDoc\PropertyTagValueNode
 	{
 		$type = $this->typeParser->parse($tokens);