Updated form/* articles to Symfony 4

javiereguiluz · javiereguiluz · commit 82afb3167f53 · 2017-11-26T18:53:32.000+01:00
diff --git a/form/action_method.rst b/form/action_method.rst
@@ -25,7 +25,7 @@ form, you can use ``setAction()`` and ``setMethod()``:
 
         class DefaultController extends Controller
         {
-            public function newAction()
+            public function new()
             {
                 $form = $this->createFormBuilder($task)
                     ->setAction($this->generateUrl('target_route'))
@@ -83,7 +83,7 @@ options:
 
         class DefaultController extends Controller
         {
-            public function newAction()
+            public function new()
             {
                 // ...
 
diff --git a/form/create_form_type_extension.rst b/form/create_form_type_extension.rst
@@ -71,6 +71,7 @@ your class as a service and using the  ``form.type_extension`` tag:
 
     .. code-block:: yaml
 
+        # config/services.yaml
         services:
             # ...
 
@@ -80,6 +81,7 @@ your class as a service and using the  ``form.type_extension`` tag:
 
     .. code-block:: xml
 
+        <!-- config/services.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -95,6 +97,7 @@ your class as a service and using the  ``form.type_extension`` tag:
 
     .. code-block:: php
 
+        // config/services.php
         use App\Form\Extension\ImageTypeExtension;
         use Symfony\Component\Form\Extension\Core\Type\FileType;
 
@@ -217,7 +220,7 @@ Specifically, you need to override the ``file_widget`` block:
 
     .. code-block:: html+twig
 
-        {# app/Resources/fields.html.twig #}
+        {# templates/form/fields.html.twig #}
         {% extends 'form_div_layout.html.twig' %}
 
         {% block file_widget %}
@@ -233,7 +236,7 @@ Specifically, you need to override the ``file_widget`` block:
 
     .. code-block:: html+php
 
-        <!-- app/Resources/file_widget.html.php -->
+        <!-- templates/form/file_widget.html.php -->
         <?php echo $view['form']->widget($form) ?>
         <?php if (null !== $image_url): ?>
             <img src="<?php echo $view['assets']->getUrl($image_url) ?>"/>
diff --git a/form/direct_submit.rst b/form/direct_submit.rst
@@ -10,7 +10,7 @@ submissions::
     use Symfony\Component\HttpFoundation\Request;
     // ...
 
-    public function newAction(Request $request)
+    public function new(Request $request)
     {
         $form = $this->createFormBuilder()
             // ...
@@ -47,7 +47,7 @@ method, pass the submitted data directly to
     use Symfony\Component\HttpFoundation\Request;
     // ...
 
-    public function newAction(Request $request)
+    public function new(Request $request)
     {
         $form = $this->createFormBuilder()
             // ...
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
@@ -344,7 +344,7 @@ In a controller, create the form like normal::
 
     class FriendMessageController extends Controller
     {
-        public function newAction(Request $request)
+        public function new(Request $request)
         {
             $form = $this->createForm(FriendMessageFormType::class);
 
@@ -392,7 +392,7 @@ sport like this::
         {
             $builder
                 ->add('sport', EntityType::class, array(
-                    'class'       => 'App:Sport',
+                    'class'       => 'App\Entity\Sport',
                     'placeholder' => '',
                 ))
             ;
@@ -409,7 +409,7 @@ sport like this::
                     $positions = null === $sport ? array() : $sport->getAvailablePositions();
 
                     $form->add('position', EntityType::class, array(
-                        'class' => 'App:Position',
+                        'class' => 'App\Entity\Position',
                         'placeholder' => '',
                         'choices' => $positions,
                     ));
@@ -456,7 +456,7 @@ The type would now look like::
         {
             $builder
                 ->add('sport', EntityType::class, array(
-                    'class'       => 'App:Sport',
+                    'class'       => 'App\Entity\Sport',
                     'placeholder' => '',
                 ));
             ;
@@ -465,7 +465,7 @@ The type would now look like::
                 $positions = null === $sport ? array() : $sport->getAvailablePositions();
 
                 $form->add('position', EntityType::class, array(
-                    'class' => 'App:Position',
+                    'class' => 'App\Entity\Position',
                     'placeholder' => '',
                     'choices' => $positions,
                 ));
@@ -518,7 +518,7 @@ your application. Assume that you have a sport meetup creation controller::
 
     class MeetupController extends Controller
     {
-        public function createAction(Request $request)
+        public function create(Request $request)
         {
             $meetup = new SportMeetup();
             $form = $this->createForm(SportMeetupType::class, $meetup);
@@ -578,7 +578,7 @@ field according to the current selection in the ``sport`` field:
 
     .. code-block:: html+php
 
-        <!-- templates/Meetup/create.html.php -->
+        <!-- templates/meetup/create.html.php -->
         <?php echo $view['form']->start($form) ?>
             <?php echo $view['form']->row($form['sport']) ?>    <!-- <select id="meetup_sport" ... -->
             <?php echo $view['form']->row($form['position']) ?> <!-- <select id="meetup_position" ... -->
diff --git a/form/form_collections.rst b/form/form_collections.rst
@@ -156,7 +156,7 @@ In your controller, you'll create a new form from the ``TaskType``::
 
     class TaskController extends Controller
     {
-        public function newAction(Request $request)
+        public function new(Request $request)
         {
             $task = new Task();
 
@@ -215,7 +215,7 @@ zero tags when first created).
 
     .. code-block:: html+php
 
-        <!-- src/Resources/views/Task/new.html.php -->
+        <!-- templates/task/new.html.php -->
 
         <!-- ... -->
 
@@ -399,7 +399,7 @@ one example:
         // Replace '__name__label__' in the prototype's HTML to
         // instead be a number based on how many items we have
         // newForm = newForm.replace(/__name__label__/g, index);
-        
+
         // Replace '__name__' in the prototype's HTML to
         // instead be a number based on how many items we have
         newForm = newForm.replace(/__name__/g, index);
@@ -510,7 +510,7 @@ you will learn about next!).
 
         .. code-block:: yaml
 
-            # src/Resources/config/doctrine/Task.orm.yml
+            # src/Resources/config/doctrine/Task.orm.yaml
             App\Entity\Task:
                 type: entity
                 # ...
@@ -681,7 +681,7 @@ the relationship between the removed ``Tag`` and ``Task`` object.
     you'll need to do more work for the removed tags to persist correctly.
 
     In this case, you can modify the controller to remove the relationship
-    on the removed tag. This assumes that you have some ``editAction()`` which
+    on the removed tag. This assumes that you have some ``edit()`` action which
     is handling the "update" of your Task::
 
         // src/Controller/TaskController.php
@@ -690,7 +690,7 @@ the relationship between the removed ``Tag`` and ``Task`` object.
         use Doctrine\Common\Collections\ArrayCollection;
 
         // ...
-        public function editAction($id, Request $request)
+        public function edit($id, Request $request)
         {
             $em = $this->getDoctrine()->getManager();
             $task = $em->getRepository(Task::class)->find($id);
diff --git a/form/form_customization.rst b/form/form_customization.rst
@@ -366,7 +366,7 @@ You can do this by including the ``only`` keyword after the list form themes:
 
     .. code-block:: html+twig
 
-        {# app/Resources/views/common.html.twig #}
+        {# templates/form/common.html.twig #}
         {% use "form_div_layout.html.twig" %}
 
         {# ... #}
@@ -433,7 +433,7 @@ method:
 
     The ``:form`` syntax is based on the functional names for templates:
     ``Bundle:Directory``. As the form directory lives in the
-    ``app/Resources/views`` directory, the ``Bundle`` part is empty, resulting
+    ``templates/`` directory, the ``Bundle`` part is empty, resulting
     in ``:form``.
 
 Referencing base Form Blocks (Twig specific)
diff --git a/form/form_dependencies.rst b/form/form_dependencies.rst
@@ -34,7 +34,7 @@ create your form::
     use App\Form\TaskType;
 
     // ...
-    public function newAction()
+    public function new()
     {
         $em = $this->getDoctrine()->getManager();
 
diff --git a/form/use_empty_data.rst b/form/use_empty_data.rst
@@ -7,9 +7,9 @@ How to Configure empty Data for a Form Class
 The ``empty_data`` option allows you to specify an empty data set for your
 form class. This empty data set would be used if you submit your form, but
 haven't called ``setData()`` on your form or passed in data when you created
-your form. For example::
+your form. For example, in a controller::
 
-    public function indexAction()
+    public function index()
     {
         $blog = ...;
 
diff --git a/form/without_class.rst b/form/without_class.rst
@@ -15,7 +15,7 @@ an array of the submitted data. This is actually really easy::
     use Symfony\Component\HttpFoundation\Request;
     // ...
 
-    public function contactAction(Request $request)
+    public function contact(Request $request)
     {
         $defaultData = array('message' => 'Type your message here');
         $form = $this->createFormBuilder($defaultData)
@@ -102,7 +102,7 @@ but here's a short example:
     If you are using validation groups, you need to either reference the
     ``Default`` group when creating the form, or set the correct group on
     the constraint you are adding.
-    
+
     .. code-block:: php
 
         new NotBlank(array('groups' => array('create', 'update')));
diff --git a/forms.rst b/forms.rst
@@ -86,7 +86,7 @@ from inside a controller::
 
     class DefaultController extends Controller
     {
-        public function newAction(Request $request)
+        public function new(Request $request)
         {
             // create a task and give it some dummy data for this example
             $task = new Task();
@@ -221,7 +221,7 @@ your controller::
     // ...
     use Symfony\Component\HttpFoundation\Request;
 
-    public function newAction(Request $request)
+    public function new(Request $request)
     {
         // just setup a fresh $task object (remove the dummy data)
         $task = new Task();
@@ -338,7 +338,7 @@ object.
 
     .. code-block:: yaml
 
-        # src/Resources/config/validation.yml
+        # src/Resources/config/validation.yaml
         App\Entity\Task:
             properties:
                 task:
@@ -516,7 +516,7 @@ the type of your field and set it up for you. In this example, Symfony can
 guess from the validation rules that both the ``task`` field is a normal
 ``TextType`` field and the ``dueDate`` field is a ``DateType`` field::
 
-    public function newAction()
+    public function new()
     {
         $task = new Task();
 
@@ -615,7 +615,7 @@ be used to quickly build a form object in the controller::
     // src/Controller/DefaultController.php
     use App\Form\TaskType;
 
-    public function newAction()
+    public function new()
     {
         $task = ...;
         $form = $this->createForm(TaskType::class, $task);
@@ -708,4 +708,3 @@ Learn more
 
 .. _`Symfony Form component`: https://github.com/symfony/form
 .. _`DateTime`: http://php.net/manual/en/class.datetime.php
-.. _`2.8 UPGRADE Log`: https://github.com/symfony/symfony/blob/2.8/UPGRADE-2.8.md#form

Original file line number	Diff line number	Diff line change
@@ -25,7 +25,7 @@ form, you can use ``setAction()`` and ``setMethod()``:
`25`	`25`
`26`	`26`	`class DefaultController extends Controller`
`27`	`27`	`{`
`28`		`- public function newAction()`
	`28`	`+ public function new()`
`29`	`29`	`{`
`30`	`30`	`$form = $this->createFormBuilder($task)`
`31`	`31`	`->setAction($this->generateUrl('target_route'))`
`@@ -83,7 +83,7 @@ options:`
`83`	`83`
`84`	`84`	`class DefaultController extends Controller`
`85`	`85`	`{`
`86`		`- public function newAction()`
	`86`	`+ public function new()`
`87`	`87`	`{`
`88`	`88`	`// ...`
`89`	`89`
Original file line number	Diff line number	Diff line change
`@@ -34,7 +34,7 @@ create your form::`
`34`	`34`	`use App\Form\TaskType;`
`35`	`35`
`36`	`36`	`// ...`
`37`		`- public function newAction()`
	`37`	`+ public function new()`
`38`	`38`	`{`
`39`	`39`	`$em = $this->getDoctrine()->getManager();`
`40`	`40`