The start of something beautiful

vendor/symfony/form/Event/PostSetDataEvent.php

@@ -0,0 +1,29 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Form\Event;
+
+use Symfony\Component\Form\Exception\BadMethodCallException;
+use Symfony\Component\Form\FormEvent;
+
+/**
+ * This event is dispatched at the end of the Form::setData() method.
+ *
+ * It can be used to modify a form depending on the populated data (adding or
+ * removing fields dynamically).
+ */
+final class PostSetDataEvent extends FormEvent
+{
+    public function setData(mixed $data): never
+    {
+        throw new BadMethodCallException('Form data cannot be changed during "form.post_set_data", you should use "form.pre_set_data" instead.');
+    }
+}

vendor/symfony/form/Event/PostSubmitEvent.php

@@ -0,0 +1,29 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Form\Event;
+
+use Symfony\Component\Form\Exception\BadMethodCallException;
+use Symfony\Component\Form\FormEvent;
+
+/**
+ * This event is dispatched after the Form::submit()
+ * once the model and view data have been denormalized.
+ *
+ * It can be used to fetch data after denormalization.
+ */
+final class PostSubmitEvent extends FormEvent
+{
+    public function setData(mixed $data): never
+    {
+        throw new BadMethodCallException('Form data cannot be changed during "form.post_submit", you should use "form.pre_submit" or "form.submit" instead.');
+    }
+}

vendor/symfony/form/Event/PreSetDataEvent.php

@@ -0,0 +1,23 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Form\Event;
+
+use Symfony\Component\Form\FormEvent;
+
+/**
+ * This event is dispatched at the beginning of the Form::setData() method.
+ *
+ * It can be used to modify the data given during pre-population.
+ */
+final class PreSetDataEvent extends FormEvent
+{
+}

vendor/symfony/form/Event/PreSubmitEvent.php

@@ -0,0 +1,25 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Form\Event;
+
+use Symfony\Component\Form\FormEvent;
+
+/**
+ * This event is dispatched at the beginning of the Form::submit() method.
+ *
+ * It can be used to:
+ *  - Change data from the request, before submitting the data to the form.
+ *  - Add or remove form fields, before submitting the data to the form.
+ */
+final class PreSubmitEvent extends FormEvent
+{
+}

vendor/symfony/form/Event/SubmitEvent.php

@@ -0,0 +1,24 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Form\Event;
+
+use Symfony\Component\Form\FormEvent;
+
+/**
+ * This event is dispatched just before the Form::submit() method
+ * transforms back the normalized data to the model and view data.
+ *
+ * It can be used to change data from the normalized representation of the data.
+ */
+final class SubmitEvent extends FormEvent
+{
+}