feat(doctrine): enhance getLinksHandler with method validation and typo suggestions (#6874)

* feat: enhance getLinksHandler with method validation and typo suggestions

- Add strict validation for method existence when handling callable arrays ([ClassName, MethodName]).
- Introduce `findSimilarMethod` to suggest the closest matching method name if a typo is detected.
- Improve error messaging by including suggestions for likely intended methods.
- Ensure robust error handling for `handleLinks` in `getLinksHandler`.

* Coding: apply CsFixer

* Coding: apply CsFixer

* Coding: apply CsFixer

* Coding: apply CsFixer

* Coding: apply CsFixer

Author: SebLevDev

src/Doctrine/Common/State/LinksHandlerLocatorTrait.php

@@ -35,10 +35,33 @@ private function getLinksHandler(Operation $operation): ?callable
             return $handleLinks;
         }
 
+        if (\is_array($handleLinks) && 2 === \count($handleLinks) && class_exists($handleLinks[0])) {
+            [$className, $methodName] = $handleLinks;
+
+            if (method_exists($className, $methodName)) {
+                return $handleLinks;
+            }
+
+            $suggestedMethod = $this->findSimilarMethod($className, $methodName);
+
+            throw new RuntimeException(\sprintf('Method "%s" does not exist in class "%s".%s', $methodName, $className, $suggestedMethod ? \sprintf(' Did you mean "%s"?', $suggestedMethod) : ''));
+        }
+
         if ($this->handleLinksLocator && \is_string($handleLinks) && $this->handleLinksLocator->has($handleLinks)) {
             return [$this->handleLinksLocator->get($handleLinks), 'handleLinks'];
         }
 
         throw new RuntimeException(\sprintf('Could not find handleLinks service "%s"', $handleLinks));
     }
+
+    private function findSimilarMethod(string $className, string $methodName): ?string
+    {
+        $methods = get_class_methods($className);
+
+        $similarMethods = array_filter($methods, function ($method) use ($methodName) {
+            return levenshtein($methodName, $method) <= 3;
+        });
+
+        return $similarMethods ? reset($similarMethods) : null;
+    }
 }