[FrameworkBundle] Deprecate framework:exceptions XML tag

MatTheCat · fabpot · commit b5eda47d913b · 2022-12-22T17:27:46.000+01:00
diff --git a/UPGRADE-6.3.md b/UPGRADE-6.3.md
@@ -7,6 +7,37 @@ DependencyInjection
  * Deprecate `PhpDumper` options `inline_factories_parameter` and `inline_class_loader_parameter`, use `inline_factories` and `inline_class_loader` instead
  * Deprecate undefined and numeric keys with `service_locator` config, use string aliases instead
 
+FrameworkBundle
+---------------
+
+ * Deprecate `framework:exceptions` tag, unwrap it and replace `framework:exception` tags' `name` attribute by `class`
+
+   Before:
+   ```xml
+   <!-- config/packages/framework.xml -->
+   <framework:config>
+       <framework:exceptions>
+           <framework:exception
+               name="Symfony\Component\HttpKernel\Exception\BadRequestHttpException"
+               log-level="info"
+               status-code="422"
+           />
+       </framework:exceptions>
+   </framework:config>
+   ```
+
+   After:
+   ```xml
+   <!-- config/packages/framework.xml -->
+   <framework:config>
+       <framework:exception
+           class="Symfony\Component\HttpKernel\Exception\BadRequestHttpException"
+           log-level="info"
+           status-code="422"
+       />
+   </framework:config>
+   ```
+
 HttpKernel
 ----------
 
diff --git a/src/Symfony/Bundle/FrameworkBundle/CHANGELOG.md b/src/Symfony/Bundle/FrameworkBundle/CHANGELOG.md
@@ -8,6 +8,7 @@ CHANGELOG
  * Allow to avoid `limit` definition in a RateLimiter configuration when using the `no_limit` policy
  * Add `--format` option to the `debug:config` command
  * Add support to pass namespace wildcard in `framework.messenger.routing`
+ * Deprecate `framework:exceptions` tag, unwrap it and replace `framework:exception` tags' `name` attribute by `class`
 
 6.2
 ---
diff --git a/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/Configuration.php b/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/Configuration.php
@@ -1202,6 +1202,8 @@ private function addExceptionsSection(ArrayNodeDefinition $rootNode)
                                 return $v;
                             }
 
+                            trigger_deprecation('symfony/framework-bundle', '6.3', '"framework:exceptions" tag is deprecated. Unwrap it and replace your "framework:exception" tags\' "name" attribute by "class".');
+
                             $v = $v['exception'];
                             unset($v['exception']);
 

Original file line number	Diff line number	Diff line change
`@@ -1202,6 +1202,8 @@ private function addExceptionsSection(ArrayNodeDefinition $rootNode)`
`1202`	`1202`	`return $v;`
`1203`	`1203`	`}`
`1204`	`1204`
	`1205`	`+ trigger_deprecation('symfony/framework-bundle', '6.3', '"framework:exceptions" tag is deprecated. Unwrap it and replace your "framework:exception" tags\' "name" attribute by "class".');`
	`1206`	`+`
`1205`	`1207`	`$v = $v['exception'];`
`1206`	`1208`	`unset($v['exception']);`
`1207`	`1209`