SDK Form demonstrator

lib/symfony/form/Event/PostSetDataEvent.php

@@ -0,0 +1,33 @@
+<?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 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
+{
+    /**
+     * @deprecated since Symfony 6.4, it will throw an exception in 7.0.
+     */
+    public function setData(mixed $data): void
+    {
+        trigger_deprecation('symfony/form', '6.4', 'Calling "%s()" will throw an exception as of 7.0, listen to "form.pre_set_data" instead.', __METHOD__);
+        // throw new BadMethodCallException('Form data cannot be changed during "form.post_set_data", you should use "form.pre_set_data" instead.');
+        parent::setData($data);
+    }
+}

lib/symfony/form/Event/PostSubmitEvent.php

@@ -0,0 +1,33 @@
+<?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 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
+{
+    /**
+     * @deprecated since Symfony 6.4, it will throw an exception in 7.0.
+     */
+    public function setData(mixed $data): void
+    {
+        trigger_deprecation('symfony/form', '6.4', 'Calling "%s()" will throw an exception as of 7.0, listen to "form.pre_submit" or "form.submit" instead.', __METHOD__);
+        // throw new BadMethodCallException('Form data cannot be changed during "form.post_submit", you should use "form.pre_submit" or "form.submit" instead.');
+        parent::setData($data);
+    }
+}

lib/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
+{
+}

lib/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
+{
+}

lib/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
+{
+}