Feature: support for $pathsAsFilePaths

This commit adds support for a `$pathsAsFilePaths` parameter,
introduced as part of doctrine/orm#12106

It adds a minor BC break (as well as was in the case of
`$reportFieldsWhereDeclared` - `8d8579`) - classes,
extending `DoctrineOrmMappingsPass` that override
`createAttributeMappingDriver()` method will face signature mismatch.

Author: rela589n

src/DependencyInjection/Compiler/DoctrineOrmMappingsPass.php

@@ -141,23 +141,25 @@ public static function createAnnotationMappingDriver(array $namespaces, array $d
     }
 
     /**
-     * @param string[]     $namespaces                List of namespaces that are handled with attribute mapping
-     * @param string[]     $directories               List of directories to look for classes with attributes
-     * @param string[]     $managerParameters         List of parameters that could which object manager name
-     *                                                your bundle uses. This compiler pass will automatically
-     *                                                append the parameter name for the default entity manager
-     *                                                to this list.
-     * @param string|false $enabledParameter          Service container parameter that must be present to
-     *                                                enable the mapping. Set to false to not do any check,
-     *                                                optional.
-     * @param string[]     $aliasMap                  Map of alias to namespace.
-     * @param bool         $reportFieldsWhereDeclared Will report fields for the classes where they are declared
+     * @param string[]         $namespaces                List of namespaces that are handled with attribute mapping
+     * @param iterable<string> $paths                     Iterable of source file path names (if {@see $pathsAsFilePaths}),
+     *                                                    or an array of directories where mapping classes can be found.
+     * @param string[]         $managerParameters         List of parameters that could which object manager name
+     *                                                    your bundle uses. This compiler pass will automatically
+     *                                                    append the parameter name for the default entity manager
+     *                                                    to this list.
+     * @param string|false     $enabledParameter          Service container parameter that must be present to
+     *                                                    enable the mapping. Set to false to not do any check,
+     *                                                    optional.
+     * @param string[]         $aliasMap                  Map of alias to namespace.
+     * @param bool             $reportFieldsWhereDeclared Will report fields for the classes where they are declared
+     * @param bool             $pathsAsFilePaths          whether {@see $paths} are paths to files or directories
      *
      * @return self
      */
-    public static function createAttributeMappingDriver(array $namespaces, array $directories, array $managerParameters = [], $enabledParameter = false, array $aliasMap = [], bool $reportFieldsWhereDeclared = false)
+    public static function createAttributeMappingDriver(array $namespaces, iterable $paths, array $managerParameters = [], $enabledParameter = false, array $aliasMap = [], bool $reportFieldsWhereDeclared = false, bool $pathsAsFilePaths = false): self
     {
-        $driver = new Definition(AttributeDriver::class, [$directories, $reportFieldsWhereDeclared]);
+        $driver = new Definition(AttributeDriver::class, [$paths, $reportFieldsWhereDeclared, $pathsAsFilePaths]);
 
         return new DoctrineOrmMappingsPass($driver, $namespaces, $managerParameters, $enabledParameter, $aliasMap);
     }