minor symfony#27560 Add note about changed form processing when using PUT requests (fnagel)

fabpot · fabpot · commit b9da7a6fd6b0 · 2018-06-25T13:05:14.000+02:00
This PR was merged into the 2.8 branch. Discussion ---------- Add note about changed form processing when using PUT requests | Q | A | ------------- | --- | Branch? | 2.8 and up? | Bug fix? | no | New feature? | no | BC breaks? | no | Deprecations? | no | Tests pass? | yes | License | MIT Added a note about changed form processing when using PUT requests as people still struggling with this change. Documenting it should help people to quickly fix this without struggling why some of their forms won't work any more after upgrading. See symfony#8261 Commits ------- 140b6c2 Add note about changed form processing when using PUT requests
diff --git a/UPGRADE-3.0.md b/UPGRADE-3.0.md
@@ -595,6 +595,24 @@ UPGRADE FROM 2.x to 3.0
       }
    }
    ```
+   
+   If the form is submitted with a different request method than `POST`, you need to configure this in the form:
+
+   Before:
+
+   ```php
+   $form = $this->createForm(FormType::class, $entity);
+   $form->submit($request);
+   ```
+
+   After:
+
+   ```php
+   $form = $this->createForm(FormType::class, $entity, [
+       'method' => 'PUT',
+   ]);
+   $form->handleRequest($request);
+   ```
 
  * The events `PRE_BIND`, `BIND` and `POST_BIND` were renamed to `PRE_SUBMIT`, `SUBMIT`
    and `POST_SUBMIT`.
