Merge branch '2.7' into 2.8

* 2.7:
  Fix missing trailling commas
  [Serializer] Added missing ObjectNormalizer
  [Serializer] By default the serializer do not convert to lower case properties
  Added a note about named form types
  Update translation.rst
  Fix UrlMatcher::match() URL

Author: javiereguiluz

best_practices/controllers.rst

@@ -111,7 +111,7 @@ for the homepage of our app:
                 ->findLatest();
 
             return $this->render('default/index.html.twig', array(
-                'posts' => $posts
+                'posts' => $posts,
             ));
         }
     }

best_practices/forms.rst

@@ -126,7 +126,7 @@ some developers configure form buttons in the controller::
             $form = $this->createForm(PostType::class, $post);
             $form->add('submit', SubmitType::class, array(
                 'label' => 'Create',
-                'attr'  => array('class' => 'btn btn-default pull-right')
+                'attr'  => array('class' => 'btn btn-default pull-right'),
             ));
 
             // ...

components/dom_crawler.rst

@@ -384,7 +384,7 @@ Pass an array of values::
     // sets multiple fields at once
     $form->setValues(array('multi' => array(
         1             => 'value',
-        'dimensional' => 'an other value'
+        'dimensional' => 'an other value',
     )));
 
 This is great, but it gets better! The ``Form`` object allows you to interact

components/http_foundation.rst

@@ -557,7 +557,7 @@ class, which can make this even easier::
 
     $response = new JsonResponse();
     $response->setData(array(
-        'data' => 123
+        'data' => 123,
     ));
 
 This encodes your array of data to JSON and sets the ``Content-Type`` header

components/routing.rst

@@ -62,7 +62,7 @@ URL path and some array of custom variables in its constructor. This array
 of custom variables can be *anything* that's significant to your application,
 and is returned when that route is matched.
 
-The :method:`UrlMatcher::match() <Symfony\\Component\\Routing\\UrlMatcher::match>`
+The :method:`UrlMatcher::match() <Symfony\\Component\\Routing\\Matcher\\UrlMatcher::match>`
 returns the variables you set on the route as well as the wildcard placeholders
 (see below). Your application can now use this information to continue
 processing the request. In addition to the configured variables, a ``_route``

components/serializer.rst

@@ -512,9 +512,10 @@ There are several types of normalizers available:
     directly and through getters, setters, hassers, adders and removers. It supports
     calling the constructor during the denormalization process.
 
-    Objects are normalized to a map of property names (method name stripped of
-    the "get"/"set"/"has"/"remove" prefix and converted to lower case) to property
-    values.
+    Objects are normalized to a map of property names and values (names are
+    generated removing the ``get``, ``set``, ``has`` or ``remove`` prefix from
+    the method name and lowercasing the first letter; e.g. ``getFirstName()`` ->
+    ``firstName``).
 
     The ``ObjectNormalizer`` is the most powerful normalizer. It is configured by
     default when using the Symfony Standard Edition with the serializer enabled.
@@ -524,8 +525,9 @@ There are several types of normalizers available:
     (public methods starting with "get"). It will denormalize data by calling
     the constructor and the "setters" (public methods starting with "set").
 
-    Objects are normalized to a map of property names (method name stripped of
-    the "get" prefix and converted to lower case) to property values.
+    Objects are normalized to a map of property names and values (names are
+    generated removing the ``get`` prefix from the method name and lowercasing
+    the first letter; e.g. ``getFirstName()`` -> ``firstName``).
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`
     This normalizer directly reads and writes public properties as well as
@@ -596,7 +598,8 @@ Circular references are common when dealing with entity relations::
     }
 
 To avoid infinite loops, :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
-throws a :class:`Symfony\\Component\\Serializer\\Exception\\CircularReferenceException`
+or :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
+throw a :class:`Symfony\\Component\\Serializer\\Exception\\CircularReferenceException`
 when such a case is encountered::
 
     $member = new Member();

components/translation.rst

@@ -34,9 +34,8 @@ The constructor of the ``Translator`` class needs one argument: The locale.
 .. code-block:: php
 
     use Symfony\Component\Translation\Translator;
-    use Symfony\Component\Translation\MessageSelector;
 
-    $translator = new Translator('fr_FR', new MessageSelector());
+    $translator = new Translator('fr_FR');
 
 .. note::
 

configuration/environments.rst

@@ -139,7 +139,6 @@ configuration file:
 
         $container->loadFromExtension('web_profiler', array(
             'toolbar' => true,
-
             // ...
         ));
 

console/style.rst

@@ -372,7 +372,6 @@ of your commands to change their appearance::
 
             // After
             $io = new CustomStyle($input, $output);
-
             // ...
         }
     }

doctrine/event_listeners_subscribers.rst

@@ -106,7 +106,7 @@ managers that use this connection.
             ->register('my.listener2', SearchIndexer2::class)
             ->addTag('doctrine.event_listener', array(
                 'event' => 'postPersist',
-                'connection' => 'default'
+                'connection' => 'default',
             ))
         ;
         $container

email/spool.rst

@@ -52,7 +52,7 @@ swiftmailer with the memory option, use the following configuration:
         // app/config/config.php
         $container->loadFromExtension('swiftmailer', array(
              // ...
-            'spool' => array('type' => 'memory')
+            'spool' => array('type' => 'memory'),
         ));
 
 .. _spool-using-a-file:

form/form_dependencies.rst

@@ -38,7 +38,7 @@ create your form::
     {
         $task = ...;
         $form = $this->createForm(TaskType::class, $task, array(
-            'entity_manager' => $this->get('doctrine.orm.entity_manager')
+            'entity_manager' => $this->get('doctrine.orm.entity_manager'),
         ));
 
         // ...

form/inherit_data_option.rst

@@ -110,7 +110,7 @@ for that::
         public function configureOptions(OptionsResolver $resolver)
         {
             $resolver->setDefaults(array(
-                'inherit_data' => true
+                'inherit_data' => true,
             ));
         }
     }

forms.rst

@@ -702,6 +702,13 @@ the choice is ultimately up to you.
 
         $form->get('agreeTerms')->setData(true);
 
+
+.. note::
+
+    The form name is automatically generated from the type class name. If you want
+    to modify it, use the :method:`Symfony\\Component\\Form\\FormFactoryInterface::createNamed` method.
+    You can even suppress the name completely by setting it to an empty string.
+
 Final Thoughts
 --------------
 

http_cache/validation.rst

@@ -218,7 +218,7 @@ exposing a simple and efficient pattern::
             // or render a template with the $response you've already started
             return $this->render('article/show.html.twig', array(
                 'article' => $article,
-                'comments' => $comments
+                'comments' => $comments,
             ), $response);
         }
     }

quick_tour/the_controller.rst

@@ -70,7 +70,7 @@ a new method called ``helloAction()`` with the following content::
         public function helloAction($name)
         {
             return $this->render('default/hello.html.twig', array(
-                'name' => $name
+                'name' => $name,
             ));
         }
     }
@@ -125,7 +125,7 @@ as its default value::
     public function helloAction($name, $_format)
     {
         return $this->render('default/hello.'.$_format.'.twig', array(
-            'name' => $name
+            'name' => $name,
         ));
     }
 
@@ -168,7 +168,7 @@ option of the ``@Route()`` annotation::
     public function helloAction($name, $_format)
     {
         return $this->render('default/hello.'.$_format.'.twig', array(
-            'name' => $name
+            'name' => $name,
         ));
     }
 

quick_tour/the_view.rst

@@ -68,8 +68,8 @@ on its type:
 
     {# 1. Simple variables #}
     {# $this->render('template.html.twig', array(
-           'name' => 'Fabien')
-       ) #}
+           'name' => 'Fabien',
+       )) #}
     {{ name }}
 
     {# 2. Arrays #}

reference/configuration/framework.rst

@@ -1328,7 +1328,7 @@ Assume you have custom global form themes in
             'templating' => array(
                 'form' => array(
                     'resources' => array(
-                        'WebsiteBundle:Form'
+                        'WebsiteBundle:Form',
                     ),
                 ),
             ),

reference/configuration/security.rst

@@ -675,11 +675,11 @@ multiple firewalls, the "context" could actually be shared:
             'firewalls' => array(
                 'somename' => array(
                     // ...
-                    'context' => 'my_context'
+                    'context' => 'my_context',
                 ),
                 'othername' => array(
                     // ...
-                    'context' => 'my_context'
+                    'context' => 'my_context',
                 ),
             ),
         ));

reference/constraints/CardScheme.rst

@@ -89,7 +89,7 @@ on an object that will contain a credit card number.
             {
                 $metadata->addPropertyConstraint('cardNumber', new Assert\CardScheme(array(
                     'schemes' => array(
-                        'VISA'
+                        'VISA',
                     ),
                     'message' => 'Your credit card number is invalid.',
                 )));

reference/constraints/Isbn.rst

@@ -99,7 +99,7 @@ on an object that will contain an ISBN.
             {
                 $metadata->addPropertyConstraint('isbn', new Assert\Isbn(array(
                     'type'    => 'isbn10',
-                    'message' => 'This value is not valid.'
+                    'message' => 'This value is not valid.',
                 )));
             }
         }

reference/forms/types/collection.rst

@@ -60,10 +60,10 @@ address as its own input text box::
 
     $builder->add('emails', CollectionType::class, array(
         // each entry in the array will be an "email" field
-        'entry_type'   => EmailType::class,
+        'entry_type' => EmailType::class,
         // these options are passed to each "email" type
-        'entry_options'  => array(
-            'attr'      => array('class' => 'email-box')
+        'entry_options' => array(
+            'attr' => array('class' => 'email-box'),
         ),
     ));
 
@@ -211,7 +211,7 @@ And update the template as follows:
         {% endfor %}
         </ul>
 
-        <a href="#" 
+        <a href="#"
             class="add-another-collection-widget"
             data-list="#email-field-list">Add another email</a>
 

reference/forms/types/date.rst

@@ -153,7 +153,7 @@ values for the year, month and day fields::
 
     $builder->add('dueDate', DateType::class, array(
         'placeholder' => array(
-            'year' => 'Year', 'month' => 'Month', 'day' => 'Day'
+            'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
         )
     ));
 

reference/forms/types/options/group_by.rst.inc

@@ -23,7 +23,7 @@ Take the following example::
             'now' => new \DateTime('now'),
             'tomorrow' => new \DateTime('+1 day'),
             '1 week' => new \DateTime('+1 week'),
-            '1 month' => new \DateTime('+1 month')
+            '1 month' => new \DateTime('+1 month'),
         ),
         'choices_as_values' => true,
         'group_by' => function($val, $key, $index) {

reference/forms/types/options/preferred_choices.rst.inc

@@ -15,10 +15,10 @@ you can list the most popular on top, like Bork Bork and Pirate::
             'English' => 'en',
             'Spanish' => 'es',
             'Bork'   => 'muppets',
-            'Pirate' => 'arr'
+            'Pirate' => 'arr',
         ),
         'choices_as_values' => true,
-        'preferred_choices' => array('muppets', 'arr')
+        'preferred_choices' => array('muppets', 'arr'),
     ));
 
 .. versionadded:: 2.7
@@ -35,7 +35,7 @@ be especially useful if your values are objects::
             'now' => new \DateTime('now'),
             'tomorrow' => new \DateTime('+1 day'),
             '1 week' => new \DateTime('+1 week'),
-            '1 month' => new \DateTime('+1 month')
+            '1 month' => new \DateTime('+1 month'),
         ),
         'choices_as_values' => true,
         'preferred_choices' => function ($val, $key) {

routing/requirements.rst

@@ -65,7 +65,7 @@ a routing ``{wildcard}`` to only match some regular expression:
         $collection->add('blog_list', new Route('/blog/{page}', array(
             '_controller' => 'AppBundle:Blog:list',
         ), array(
-            'page' => '\d+'
+            'page' => '\d+',
         )));
 
         // ...

security/access_control.rst

@@ -209,11 +209,11 @@ pattern so that it is only accessible by requests from the local server itself:
                 array(
                     'path' => '^/internal',
                     'role' => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                    'ips' => '127.0.0.1, ::1'
+                    'ips' => '127.0.0.1, ::1',
                 ),
                 array(
                     'path' => '^/internal',
-                    'role' => 'ROLE_NO_ACCESS'
+                    'role' => 'ROLE_NO_ACCESS',
                 ),
             ),
         ));

security/csrf_in_login_form.rst

@@ -211,7 +211,7 @@ After this, you have protected your login form against CSRF attacks.
                         'form_login' => array(
                             // ...
                             'csrf_parameter' => '_csrf_security_token',
-                            'csrf_token_id'     => 'a_private_string'
+                            'csrf_token_id'  => 'a_private_string',
                         ),
                     ),
                 ),

security/entity_provider.rst

@@ -375,14 +375,14 @@ so you only need the new interface::
         {
             return serialize(array(
                 // ...
-                $this->isActive
+                $this->isActive,
             ));
         }
         public function unserialize($serialized)
         {
             list (
                 // ...
-                $this->isActive
+                $this->isActive,
             ) = unserialize($serialized);
         }
     }

security/impersonating_user.rst

@@ -228,7 +228,7 @@ the sticky locale:
             ->register('app.switch_user_listener', SwitchUserListener::class)
             ->addTag('kernel.event_listener', array(
                 'event' => 'security.switch_user',
-                'method' => 'onSwitchUser'
+                'method' => 'onSwitchUser',
             ))
         ;
 

security/named_encoders.rst

@@ -96,7 +96,7 @@ named encoders:
             'encoders' => array(
                 'harsh' => array(
                     'algorithm' => 'bcrypt',
-                    'cost'      => '15'
+                    'cost'      => '15',
                 ),
             ),
         ));
@@ -165,7 +165,7 @@ you must register a service for it in order to use it as a named encoder:
             // ...
             'encoders' => array(
                 'app_encoder' => array(
-                    'id' => 'app.password_encoder_service'
+                    'id' => 'app.password_encoder_service',
                 ),
             ),
         ));

service_container/definitions.rst

@@ -79,7 +79,7 @@ fetched from the container::
 
     $definition = new Definition(DoctrineConfigManager::class, array(
         new Reference('doctrine'), // a reference to another service
-        '%app.config_table_name%'  // will be resolved to the value of a container parameter
+        '%app.config_table_name%',  // will be resolved to the value of a container parameter
     ));
 
     // gets all arguments configured for this definition