Feature: add support for ClassLocator from doctrine/persistence 4.1

These changes integrate doctrine/persistence#433
`ClassLocator` allows clients to pass any iterable of classes they might want.

Author: rela589n

.phpstan/phpstan-baseline.neon

@@ -40,3 +40,24 @@ parameters:
             message: "#^Call to an undefined method Doctrine\\\\ODM\\\\PHPCR\\\\Query\\\\Builder\\\\AbstractNode\\:\\:setConverter\\(\\)\\.$#"
             count: 1
             path: ../tests/Doctrine/Tests/ODM/PHPCR/Query/Builder/QueryBuilderTest.php
+
+        -
+            message: '#^Access to an undefined property Doctrine\\ODM\\PHPCR\\Mapping\\Driver\\AttributeDriver\:\:\$classLocator\.$#'
+            identifier: property.notFound
+            count: 1
+            path: ../lib/Doctrine/ODM/PHPCR/Mapping/Driver/AttributeDriver.php
+            reportUnmatched: false
+
+        -
+            message: '#^Class Doctrine\\Persistence\\Mapping\\Driver\\ClassLocator not found\.$#'
+            identifier: class.notFound
+            count: 1
+            path: ../lib/Doctrine/ODM/PHPCR/Mapping/Driver/AttributeDriver.php
+            reportUnmatched: false
+
+        -
+            message: '#^Parameter \$paths of method Doctrine\\ODM\\PHPCR\\Mapping\\Driver\\AttributeDriver\:\:__construct\(\) has invalid type Doctrine\\Persistence\\Mapping\\Driver\\ClassLocator\.$#'
+            identifier: class.notFound
+            count: 2
+            path: ../lib/Doctrine/ODM/PHPCR/Mapping/Driver/AttributeDriver.php
+            reportUnmatched: false

lib/Doctrine/ODM/PHPCR/Mapping/Driver/AttributeDriver.php

@@ -27,6 +27,7 @@
 use Doctrine\ODM\PHPCR\Mapping\ClassMetadata;
 use Doctrine\ODM\PHPCR\Mapping\MappingException;
 use Doctrine\Persistence\Mapping\ClassMetadata as PersistenceClassMetadata;
+use Doctrine\Persistence\Mapping\Driver\ClassLocator;
 use Doctrine\Persistence\Mapping\Driver\ColocatedMappingDriver;
 use Doctrine\Persistence\Mapping\Driver\MappingDriver;
 
@@ -55,12 +56,17 @@ class AttributeDriver implements MappingDriver
     private AttributeReader $reader;
 
     /**
-     * @param array<string> $paths
+     * @param array<string>|ClassLocator $paths directory paths or class locator
      */
-    public function __construct(array $paths)
+    public function __construct(array|ClassLocator $paths)
     {
         $this->reader = new AttributeReader();
-        $this->addPaths($paths);
+
+        if ($paths instanceof ClassLocator) {
+            $this->classLocator = $paths;
+        } else {
+            $this->addPaths($paths);
+        }
     }
 
     public function isTransient($className): bool

tests/Doctrine/Tests/ODM/PHPCR/Mapping/AttributeDriverTest.php

@@ -3,24 +3,28 @@
 namespace Doctrine\Tests\ODM\PHPCR\Mapping;
 
 use Doctrine\ODM\PHPCR\Mapping\Driver\AttributeDriver;
+use Doctrine\Persistence\Mapping\Driver\FileClassLocator;
 use Doctrine\Persistence\Mapping\Driver\MappingDriver;
 
 /**
  * @group mapping
  */
 class AttributeDriverTest extends AbstractMappingDriverTest
 {
-    protected function loadDriver(): AttributeDriver
+    /** @param list<string> $paths */
+    protected function loadDriver(array $paths = []): AttributeDriver
     {
-        return new AttributeDriver([]);
+        // Available in Doctrine Persistence 4.1+
+        if (class_exists(FileClassLocator::class)) {
+            $paths = FileClassLocator::createFromDirectories($paths);
+        }
+
+        return new AttributeDriver($paths);
     }
 
     protected function loadDriverForTestMappingDocuments(): MappingDriver
     {
-        $attributeDriver = $this->loadDriver();
-        $attributeDriver->addPaths([__DIR__.'/Model']);
-
-        return $attributeDriver;
+        return $this->loadDriver([__DIR__.'/Model']);
     }
 
     /**