[Form] Deprecate FormEvent::setData() for events that do not allow it

HeahDude · HeahDude · commit c0817892b702 · 2023-07-20T15:34:24.000+02:00
diff --git a/UPGRADE-6.4.md b/UPGRADE-6.4.md
@@ -29,6 +29,7 @@ Form
 
  * Deprecate using `DateTime` or `DateTimeImmutable` model data with a different timezone than configured with the
    `model_timezone` option in `DateType`, `DateTimeType`, and `TimeType`
+ * Deprecate `PostSetDataEvent::setData()` and `PostSubmitEvent::setData()`, these methods will throw an exception starting with 7.0
 
 FrameworkBundle
 ---------------
diff --git a/src/Symfony/Component/Form/CHANGELOG.md b/src/Symfony/Component/Form/CHANGELOG.md
@@ -6,6 +6,7 @@ CHANGELOG
 
  * Deprecate using `DateTime` or `DateTimeImmutable` model data with a different timezone than configured with the
    `model_timezone` option in `DateType`, `DateTimeType`, and `TimeType`
+ * Deprecate `PostSetDataEvent::setData()` and `PostSubmitEvent::setData()`, these methods will throw an exception starting with 7.0
 
 6.3
 ---
diff --git a/src/Symfony/Component/Form/Event/PostSetDataEvent.php b/src/Symfony/Component/Form/Event/PostSetDataEvent.php
@@ -11,6 +11,7 @@
 
 namespace Symfony\Component\Form\Event;
 
+use Symfony\Component\Form\Exception\BadMethodCallException;
 use Symfony\Component\Form\FormEvent;
 
 /**
@@ -20,4 +21,11 @@
  */
 final class PostSetDataEvent extends FormEvent
 {
+    /**
+     * @deprecated since Symfony 6.4, it will throw an exception in 7.0.
+     */
+    public function setData(mixed $data)
+    {
+        // throw new BadMethodCallException('Form data cannot be changed during "form.post_set_data", you should use "form.pre_set_data" instead.');
+    }
 }
diff --git a/src/Symfony/Component/Form/Event/PostSubmitEvent.php b/src/Symfony/Component/Form/Event/PostSubmitEvent.php
@@ -21,4 +21,11 @@
  */
 final class PostSubmitEvent extends FormEvent
 {
+    /**
+     * @deprecated since Symfony 6.4, it will throw an exception in 7.0.
+     */
+    public function setData(mixed $data)
+    {
+        // throw new BadMethodCallException('Form data cannot be changed during "form.post_submit", you should use "form.pre_submit" or "form.submit" instead.');
+    }
 }

Original file line number	Diff line number	Diff line change
`@@ -21,4 +21,11 @@`
`21`	`21`	`*/`
`22`	`22`	`final class PostSubmitEvent extends FormEvent`
`23`	`23`	`{`
	`24`	`+ /**`
	`25`	`+ * @deprecated since Symfony 6.4, it will throw an exception in 7.0.`
	`26`	`+ */`
	`27`	`+ public function setData(mixed $data)`
	`28`	`+ {`
	`29`	`+ // throw new BadMethodCallException('Form data cannot be changed during "form.post_submit", you should use "form.pre_submit" or "form.submit" instead.');`
	`30`	`+ }`
`24`	`31`	`}`