qa: add documentation comment on PHPStan extension

CuyZ · Apr 2, 2024 · c8174bf · c8174bf
1 parent fa8bb00
commit c8174bf
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/qa/PHPStan/Extension/TreeMapperPHPStanExtension.php b/qa/PHPStan/Extension/TreeMapperPHPStanExtension.php
@@ -50,6 +50,10 @@ public function getTypeFromMethodCall(MethodReflection $methodReflection, Method
         try {
             return $this->type($type);
         } catch (ParserException) {
+            // Fallback to `mixed` type if the type cannot be resolved. This can
+            // occur with a type that is not understood/supported by PHPStan. If
+            // that happens, returning a mixed type is the safest option, as it
+            // will not make the analysis fail.
             return new MixedType();
         }
     }