Merge pull request #463 from greg0ire/dont-cast-null

Do not cast null to array

Author: greg0ire

lib/Doctrine/Common/Annotations/DocLexer.php

@@ -130,10 +130,14 @@ protected function getType(&$value)
     }
 
     /** @return array{value: int|string, type:self::T_*|null, position:int} */
-    public function peek(): array
+    public function peek(): ?array
     {
         $token = parent::peek();
 
+        if ($token === null) {
+            return null;
+        }
+
         return (array) $token;
     }
 }

phpstan.neon

@@ -22,5 +22,3 @@ parameters:
 
         # That tag is empty on purpose
         - '#PHPDoc tag @var has invalid value \(\)\: Unexpected token "\*/", expected type at offset 9#'
-        # Backwards-compatibility
-        - '#^Return type.*of method.*DocLexer::peek.*should be compatible.*$#'

tests/Doctrine/Tests/Common/Annotations/DocLexerTest.php

@@ -320,4 +320,9 @@ public function testTokenAdjacency(): void
         self::assertFalse($lexer->nextTokenIsAdjacent());
         self::assertFalse($lexer->moveNext());
     }
+
+    public function testItReturnsNullWhenThereIsNothingToParse(): void
+    {
+        self::assertNull((new DocLexer())->peek());
+    }
 }