Add support for ObjectStorage::next() and current()

Add some very basic support for ObjectStorage methods next()
and current(). This one could be very unstable but works in
my usecase.

Author: sascha-egerer

extension.neon

@@ -15,3 +15,7 @@ services:
         class: SaschaEgerer\PhpstanTypo3\Type\QueryInterfaceDynamicReturnTypeExtension
         tags:
             - phpstan.broker.dynamicMethodReturnTypeExtension
+    -
+        class: SaschaEgerer\PhpstanTypo3\Type\ObjectStorageDynamicReturnTypeExtension
+        tags:
+            - phpstan.broker.dynamicMethodReturnTypeExtension

src/Type/ObjectStorageDynamicReturnTypeExtension.php

@@ -0,0 +1,57 @@
+<?php
+declare(strict_types=1);
+
+namespace SaschaEgerer\PhpstanTypo3\Type;
+
+use PhpParser\Node\Expr\MethodCall;
+use PHPStan\Analyser\Scope;
+use PHPStan\Type\DynamicMethodReturnTypeExtension;
+use PHPStan\Type\ObjectType;
+use PHPStan\Type\Type;
+use PHPStan\Reflection\MethodReflection;
+use PHPStan\Type\TypeCombinator;
+use TYPO3\CMS\Extbase\Persistence\ObjectStorage;
+
+/**
+ * Add support for ObjectStorage methods "current" and "next".
+ * The target type is fetched by getting the propertyName, calculated by the getter,
+ * and then getting the property annotation of the class.
+ * This one could be very unstable but works for "my" current usecase.
+ */
+class ObjectStorageDynamicReturnTypeExtension implements DynamicMethodReturnTypeExtension
+{
+    public function getClass(): string
+    {
+        return ObjectStorage::class;
+    }
+
+    public function isMethodSupported(
+        MethodReflection $methodReflection
+    ): bool {
+        return in_array($methodReflection->getName(), ['current', 'next']);
+    }
+
+    public function getTypeFromMethodCall(
+        MethodReflection $methodReflection,
+        MethodCall $methodCall,
+        Scope $scope
+    ): Type {
+        if (strpos($methodCall->var->name, 'get') === 0) {
+            $propertyName = lcfirst(substr($methodCall->var->name, 3));
+
+            $class = $scope->getClassReflection();
+            if ($class->hasProperty($propertyName)) {
+                preg_match(
+                    '/@var\\ \\\\TYPO3\\\\CMS\\\\Extbase\\\\Persistence\\\\ObjectStorage<(.*)>/',
+                    $class->getNativeReflection()->getProperty($propertyName)->getDocComment(),
+                    $phpDocVarAnnotations
+                );
+                if (!empty($phpDocVarAnnotations[1])) {
+                    return TypeCombinator::addNull(new ObjectType($phpDocVarAnnotations[1]));
+                }
+            }
+        }
+
+        return $methodReflection->getReturnType();
+    }
+}