Test for special multiline PHPDoc

Author: ondrejmirtes

tests/PHPStan/Parser/PhpDocParserTest.php

@@ -3881,6 +3881,46 @@ public function provideMultiLinePhpDocData(): iterable
 				new PhpDocTextNode('test'),
 			]),
 		];
+
+		yield [
+			'Real-world test case multiline PHPDoc',
+			'/**' . PHP_EOL .
+			' *' . PHP_EOL .
+			' * MultiLine' . PHP_EOL .
+			' * description' . PHP_EOL .
+			' * @param bool $a' . PHP_EOL .
+			' *' . PHP_EOL .
+			' * @return void' . PHP_EOL .
+			' *' . PHP_EOL .
+			' * @throws \Exception' . PHP_EOL .
+			' *' . PHP_EOL .
+			' */',
+			new PhpDocNode([
+				new PhpDocTextNode(''),
+				new PhpDocTextNode(
+					'MultiLine' . PHP_EOL .
+					'description'
+				),
+				new PhpDocTagNode('@param', new ParamTagValueNode(
+					new IdentifierTypeNode('bool'),
+					false,
+					'$a',
+					'',
+					false
+				)),
+				new PhpDocTextNode(''),
+				new PhpDocTagNode('@return', new ReturnTagValueNode(
+					new IdentifierTypeNode('void'),
+					''
+				)),
+				new PhpDocTextNode(''),
+				new PhpDocTagNode('@throws', new ThrowsTagValueNode(
+					new IdentifierTypeNode('\Exception'),
+					''
+				)),
+				new PhpDocTextNode(''),
+			]),
+		];
 	}
 
 	public function provideTemplateTagsData(): Iterator
@@ -7582,6 +7622,45 @@ public function dataTextBetweenTagsBelongsToDescription(): iterable
 				),
 			]),
 		];
+
+		yield [
+			'/**' . PHP_EOL .
+			' *' . PHP_EOL .
+			' * MultiLine' . PHP_EOL .
+			' * description' . PHP_EOL .
+			' * @param bool $a' . PHP_EOL .
+			' *' . PHP_EOL .
+			' * @return void' . PHP_EOL .
+			' *' . PHP_EOL .
+			' * @throws \Exception' . PHP_EOL .
+			' *' . PHP_EOL .
+			' */',
+			new PhpDocNode([
+				new PhpDocTextNode(
+					PHP_EOL .
+					'MultiLine' . PHP_EOL .
+					'description'
+				),
+				new PhpDocTagNode('@param', new ParamTagValueNode(
+					new IdentifierTypeNode('bool'),
+					false,
+					'$a',
+					'',
+					false
+				)),
+				new PhpDocTextNode(''),
+				new PhpDocTagNode('@return', new ReturnTagValueNode(
+					new IdentifierTypeNode('void'),
+					''
+				)),
+				new PhpDocTextNode(''),
+				new PhpDocTagNode('@throws', new ThrowsTagValueNode(
+					new IdentifierTypeNode('\Exception'),
+					''
+				)),
+				new PhpDocTextNode(''),
+			]),
+		];
 	}
 
 	/**