Update direct_submit.rst

KamilKubicki · javiereguiluz · commit 60f5034bfd6c · 2021-04-21T15:20:11.000+02:00
Updating the rules for payload data submission  - payload fields should equal FormType class describing the Form structure
diff --git a/form/direct_submit.rst b/form/direct_submit.rst
@@ -59,3 +59,12 @@ control over when exactly your form is submitted and what data is passed to it::
 
         // 'email' and 'username' are added manually to force their validation
         $form->submit(array_merge(['email' => null, 'username' => null], $request->request->all()), false);
+        
+.. caution::
+
+    When submitting a form via a "POST" request and manually submitting the form 
+    with ``submit()``, ensure that list of fields in payload equals the list of validated 
+    fields in FormType class - in other case the form validation will fail.
+
+    //'json' represents payload data (used frequently by api client as React/Angular/Vue etc.)
+    $form->submit(array_merge($json, $request->request->all()));
