Deprecate not setting doctrine.orm.controller_resolver.auto_mapping

DependencyInjection/Configuration.php

@@ -515,7 +515,7 @@ private function addOrmSection(ArrayNodeDefinition $node): void
                             ->canBeDisabled()
                             ->children()
                                 ->booleanNode('auto_mapping')
-                                    ->defaultTrue()
+                                    ->defaultNull()
                                     ->info('Set to false to disable using route placeholders as lookup criteria when the primary key doesn\'t match the argument name')
                                 ->end()
                                 ->booleanNode('evict_cache')

DependencyInjection/DoctrineExtension.php

@@ -501,6 +501,11 @@ protected function ormLoad(array $config, ContainerBuilder $container)
                 $controllerResolverDefaults['disabled'] = true;
             }
 
+            if ($config['controller_resolver']['auto_mapping'] === null) {
+                trigger_deprecation('doctrine/doctrine-bundle', '2.12', 'The default value of "doctrine.orm.controller_resolver.auto_mapping" will be changed from `true` to `false`. Explicitly configure `true` to keep existing behaviour.');
+                $config['controller_resolver']['auto_mapping'] = true;
+            }
+
             if (! $config['controller_resolver']['auto_mapping']) {
                 $controllerResolverDefaults['mapping'] = [];
             }

UPGRADE-2.12.md

@@ -0,0 +1,13 @@
+UPGRADE FROM 2.11 to 2.12
+========================
+
+Configuration
+-------------
+
+### Controller resolver auto mapping default configuration will be changed
+
+The default value of `doctrine.orm.controller_resolver.auto_mapping` will be changed from `true` to `false` in 3.0.
+
+Auto mapping uses any route parameter that matches with a field name of the Entity to resolve as criteria in a find by query.
+
+If you are relying on this functionality, you will need to configure it explicitly to silence the deprecation notice.

UPGRADE-3.0.md

@@ -1,6 +1,17 @@
 UPGRADE FROM 2.x to 3.0
 =======================
 
+Configuration
+-------------
+
+### Controller resolver auto mapping default configuration changed
+
+The default value of `doctrine.orm.controller_resolver.auto_mapping` has changed from `true` to `false`.
+
+Auto mapping uses any route parameter that matches with a field name of the Entity to resolve as criteria in a find by query.
+
+If you were relying on this functionality, you will need to explicitly configure this now.
+
 Types
 -----