Deprecate fixture_loader option

DependencyInjection/Configuration.php

@@ -7,20 +7,15 @@
 use Doctrine\ODM\MongoDB\Configuration as ODMConfiguration;
 use Doctrine\ODM\MongoDB\Repository\DefaultGridFSRepository;
 use Doctrine\ODM\MongoDB\Repository\DocumentRepository;
-use LogicException;
-use Symfony\Bridge\Doctrine\DataFixtures\ContainerAwareLoader;
 use Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition;
 use Symfony\Component\Config\Definition\Builder\TreeBuilder;
 use Symfony\Component\Config\Definition\ConfigurationInterface;
 
-use function class_parents;
 use function count;
-use function in_array;
 use function is_array;
 use function is_string;
 use function json_decode;
 use function preg_match;
-use function sprintf;
 
 /**
  * FrameworkExtension configuration structure.
@@ -84,15 +79,11 @@ public function getConfigTreeBuilder()
                 ->scalarNode('persistent_collection_dir')->defaultValue('%kernel.cache_dir%/doctrine/odm/mongodb/PersistentCollections')->end()
                 ->scalarNode('auto_generate_persistent_collection_classes')->defaultValue(ODMConfiguration::AUTOGENERATE_NEVER)->end()
                 ->scalarNode('fixture_loader')
-                    ->defaultValue(ContainerAwareLoader::class)
-                    ->beforeNormalization()
-                        ->ifTrue(static function ($v) {
-                            return ! ($v === ContainerAwareLoader::class || in_array(ContainerAwareLoader::class, class_parents($v)));
-                        })
-                        ->then(static function ($v) {
-                            throw new LogicException(sprintf('The %s class is not a subclass of the ContainerAwareLoader', $v));
-                        })
-                    ->end()
+                    ->setDeprecated(
+                        'doctrine/mongodb-odm-bundle',
+                        '4.7',
+                        'The "fixture_loader" option is deprecated and will be dropped in doctrine/mongodb-odm-bundle 5.0.',
+                    )
                 ->end()
                 ->scalarNode('default_document_manager')->end()
                 ->scalarNode('default_connection')->end()

DependencyInjection/DoctrineMongoDBExtension.php

@@ -95,9 +95,6 @@ public function load(array $configs, ContainerBuilder $container)
         $config = $this->overrideParameters($config, $container);
 
         if (class_exists(DataFixturesLoader::class)) {
-            // set the fixtures loader
-            $container->setParameter('doctrine_mongodb.odm.fixture_loader', $config['fixture_loader']);
-
             // Autowiring fixture loader
             $container->registerForAutoconfiguration(ODMFixtureInterface::class)
                 ->addTag(FixturesCompilerPass::FIXTURE_TAG);

Resources/doc/config.rst

@@ -618,7 +618,6 @@ Full Default Configuration
             default_document_manager:  ~
             default_connection:   ~
             default_database:     default
-            fixture_loader:       Symfony\Bridge\Doctrine\DataFixtures\ContainerAwareLoader
 
     .. code-block:: xml
 

Tests/DependencyInjection/ConfigurationTest.php

@@ -5,6 +5,7 @@
 namespace Doctrine\Bundle\MongoDBBundle\Tests\DependencyInjection;
 
 use Doctrine\Bundle\MongoDBBundle\DependencyInjection\Configuration;
+use Doctrine\Bundle\MongoDBBundle\Loader\SymfonyFixturesLoader;
 use Doctrine\Bundle\MongoDBBundle\Tests\Fixtures\Filter\BasicFilter;
 use Doctrine\Bundle\MongoDBBundle\Tests\Fixtures\Filter\ComplexFilter;
 use Doctrine\Bundle\MongoDBBundle\Tests\Fixtures\Filter\DisabledFilter;
@@ -13,9 +14,8 @@
 use Doctrine\ODM\MongoDB\Configuration as ODMConfiguration;
 use Doctrine\ODM\MongoDB\Repository\DefaultGridFSRepository;
 use Doctrine\ODM\MongoDB\Repository\DocumentRepository;
-use LogicException;
 use PHPUnit\Framework\TestCase;
-use Symfony\Bridge\Doctrine\DataFixtures\ContainerAwareLoader;
+use Symfony\Bridge\PhpUnit\ExpectDeprecationTrait;
 use Symfony\Component\Config\Definition\Exception\InvalidConfigurationException;
 use Symfony\Component\Config\Definition\Processor;
 use Symfony\Component\Config\Util\XmlUtils;
@@ -26,14 +26,15 @@
 
 class ConfigurationTest extends TestCase
 {
+    use ExpectDeprecationTrait;
+
     public function testDefaults(): void
     {
         $processor     = new Processor();
         $configuration = new Configuration();
         $options       = $processor->processConfiguration($configuration, []);
 
         $defaults = [
-            'fixture_loader'                 => ContainerAwareLoader::class,
             'auto_generate_hydrator_classes' => false,
             'auto_generate_proxy_classes'    => ODMConfiguration::AUTOGENERATE_EVAL,
             'auto_generate_persistent_collection_classes' => ODMConfiguration::AUTOGENERATE_NEVER,
@@ -66,7 +67,6 @@ public function testFullConfiguration(array $config): void
         $options       = $processor->processConfiguration($configuration, [$config]);
 
         $expected = [
-            'fixture_loader'                 => ContainerAwareLoader::class,
             'auto_generate_hydrator_classes' => 1,
             'auto_generate_proxy_classes'    => ODMConfiguration::AUTOGENERATE_FILE_NOT_EXISTS,
             'auto_generate_persistent_collection_classes' => ODMConfiguration::AUTOGENERATE_EVAL,
@@ -517,27 +517,18 @@ public function testNullReplicaSetValue(): void
         $this->assertFalse(array_key_exists('replicaSet', $processedConfig['connections']['conn1']['options']));
     }
 
-    /** @dataProvider provideExceptionConfiguration */
-    public function testFixtureLoaderValidation(array $config): void
+    /** @group legacy */
+    public function testFixtureLoaderDeprecated(): void
     {
+        $config = [
+            'fixture_loader' => SymfonyFixturesLoader::class,
+        ];
+
         $processor     = new Processor();
         $configuration = new Configuration();
-        $this->expectException(LogicException::class);
-        $processor->processConfiguration($configuration, [$config]);
-    }
-
-    /** @return array<mixed[]> */
-    public static function provideExceptionConfiguration(): array
-    {
-        $yaml = Yaml::parse(file_get_contents(__DIR__ . '/Fixtures/config/yml/exception.yml'));
-        $yaml = $yaml['doctrine_mongodb'];
 
-        $xml = XmlUtils::loadFile(__DIR__ . '/Fixtures/config/xml/exception.xml');
-        $xml = XmlUtils::convertDomElementToArray($xml->getElementsByTagName('config')->item(0));
+        $this->expectDeprecation('Since doctrine/mongodb-odm-bundle 4.7: The "fixture_loader" option is deprecated and will be dropped in doctrine/mongodb-odm-bundle 5.0.');
 
-        return [
-            [$yaml],
-            [$xml],
-        ];
+        $processor->processConfiguration($configuration, [$config]);
     }
 }

Tests/DependencyInjection/Fixtures/config/xml/full.xml

@@ -7,7 +7,6 @@
                         http://symfony.com/schema/dic/doctrine/odm/mongodb http://symfony.com/schema/dic/doctrine/odm/mongodb/mongodb-1.0.xsd">
 
     <doctrine:config
-        fixture_loader="Symfony\Bridge\Doctrine\DataFixtures\ContainerAwareLoader"
         auto-generate-hydrator-classes="true"
         auto-generate-proxy-classes="true"
         auto-generate-persistent-collection-classes="3"

Tests/DependencyInjection/Fixtures/config/yml/full.yml

@@ -1,5 +1,4 @@
 doctrine_mongodb:
-    fixture_loader: Symfony\Bridge\Doctrine\DataFixtures\ContainerAwareLoader
     auto_generate_proxy_classes: 2
     auto_generate_hydrator_classes: true
     auto_generate_persistent_collection_classes: 3

UPGRADE-4.7.md

@@ -5,3 +5,7 @@ UPGRADE FROM 4.6 to 4.7
 
 * The bundle now requires PHP 8.1 or newer. If you're not running PHP 8.1 yet,
   it's recommended that you upgrade to PHP 8.1 before upgrading the bundle.
+
+* The `fixture_loader` configuration option was deprecated and will be removed
+  in 5.0.
+* The `doctrine_mongodb.odm.fixture_loader` parameter has been removed.