minor #13850 [Form] Update direct_submit.rst (KamilKubicki)

javiereguiluz · javiereguiluz · commit a92442ab28c2 · 2021-04-21T15:20:19.000+02:00
This PR was submitted for the 5.1 branch but it was merged into the 5.2 branch instead. Discussion ---------- [Form] Update direct_submit.rst Updating the rules for payload data submission - payload fields should equal FormType class describing the Form structure  Commits ------- 60f5034 Update direct_submit.rst
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()));
