Merge branch '2.8' into 3.3

* 2.8: (21 commits)
  Update resources.rst
  Update events.rst
  Improved a help note about authentication providers
  [#8280] add missing trailing comma
  [#8282] fix regex delimiters
  Add missing comment
  validateValue() is deprecated in 3.0
  prefer getObject as getEntity is deprecated
  Update serializer.rst
  [#8308] fix commands order
  Update NotIdenticalTo.rst
  Correct psr/log package name
  Update debugging.rst
  Update group_service_resolver.rst
  Update remember_me.rst
  Update expression_language.rst
  [VarDumper] s/dump.dump_destination/debug.dump_destination/
  fix schema_filter example
  fix form collection label not correct
  Improved the explanation about the doctrine caching services
  ...

Author: xabbuh

components/console/logger.rst

@@ -9,7 +9,7 @@ The Console component comes with a standalone logger complying with the
 be sent to the :class:`Symfony\\Component\\Console\\Output\\OutputInterface`
 instance passed as a parameter to the constructor.
 
-The logger does not have any external dependency except ``php-fig/log``.
+The logger does not have any external dependency except ``psr/log``.
 This is useful for console applications and commands needing a lightweight
 PSR-3 compliant logger::
 

components/serializer.rst

@@ -405,7 +405,7 @@ class extending :class:`Symfony\\Component\\Serializer\\Normalizer\\AbstractNorm
 including :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
 and :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`::
 
-    use Symfony\Component\Serializer\Encoder\JsonEncoder
+    use Symfony\Component\Serializer\Encoder\JsonEncoder;
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
     use Symfony\Component\Serializer\Serializer;
 

components/validator/resources.rst

@@ -173,14 +173,14 @@ Using a Custom MetadataFactory
 ------------------------------
 
 All the loaders and the cache are passed to an instance of
-:class:`Symfony\\Component\\Validator\\Mapping\\ClassMetadataFactory`. This
-class is responsible for creating a ``ClassMetadata`` instance from all the
+:class:`Symfony\\Component\\Validator\\Mapping\\Factory\\LazyLoadingMetadataFactory`. 
+This class is responsible for creating a ``ClassMetadata`` instance from all the
 configured resources.
 
 You can also use a custom metadata factory implementation by creating a class
 which implements
-:class:`Symfony\\Component\\Validator\\MetadataFactoryInterface`. You can set
-this custom implementation using
+:class:`Symfony\\Component\\Validator\\Mapping\\Factory\\MetadataFactoryInterface`. 
+You can set this custom implementation using
 :method:`Symfony\\Component\\Validator\\ValidatorBuilder::setMetadataFactory`::
 
     use Acme\Validation\CustomMetadataFactory;

components/var_dumper.rst

@@ -101,7 +101,7 @@ Choosing between both is mostly a matter of personal taste, still:
   be suited to your use case (e.g. you shouldn't use it in an HTML
   attribute or a ``<script>`` tag).
 
-This behavior can be changed by configuring the ``dump.dump_destination``
+This behavior can be changed by configuring the ``debug.dump_destination``
 option. Read more about this and other options in
 :doc:`the DebugBundle configuration reference </reference/configuration/debug>`.
 

debug/debugging.rst

@@ -75,6 +75,9 @@ that can help you visualize and find the information.
 ``debug:config``
     Shows all configured bundles, their class and their alias.
 
+``debug:event-dispatcher``
+    Displays information about all the registered listeners in the event dispatcher.
+
 ``debug:router``
     Displays information about all configured routes in the application as a
     table with the name, method, scheme, host and path for each route.

doctrine/event_listeners_subscribers.rst

@@ -165,7 +165,7 @@ interface and have an event method for each event it subscribes to::
 
         public function index(LifecycleEventArgs $args)
         {
-            $entity = $args->getEntity();
+            $entity = $args->getObject();
 
             // perhaps you only want to act on some "Product" entity
             if ($entity instanceof Product) {

form/events.rst

@@ -84,8 +84,8 @@ View data        ``null``
 
 .. sidebar:: ``FormEvents::PRE_SET_DATA`` in the Form component
 
-    The ``collection`` form type relies on the
-    ``Symfony\Component\Form\Extension\Core\EventListener\ResizeFormListener``
+    The ``Symfony\Component\Form\Extension\Core\Type\CollectionType`` form type relies
+    on the ``Symfony\Component\Form\Extension\Core\EventListener\ResizeFormListener``
     subscriber, listening to the ``FormEvents::PRE_SET_DATA`` event in order
     to reorder the form's fields depending on the data from the pre-populated
     object, by removing and adding all form rows.

form/form_collections.rst

@@ -130,7 +130,8 @@ Notice that you embed a collection of ``TagType`` forms using the
             $builder->add('description');
 
             $builder->add('tags', CollectionType::class, array(
-                'entry_type' => TagType::class
+                'entry_type' => TagType::class,
+                'entry_options' => array('label' => false),
             ));
         }
 
@@ -285,8 +286,9 @@ add the ``allow_add`` option to your collection field::
         $builder->add('description');
 
         $builder->add('tags', CollectionType::class, array(
-            'entry_type'   => TagType::class,
-            'allow_add'    => true,
+            'entry_type' => TagType::class,
+            'entry_options' => array('label' => false),
+            'allow_add' => true,
         ));
     }
 
@@ -392,9 +394,15 @@ one example:
         // get the new index
         var index = $collectionHolder.data('index');
 
+        var newForm = prototype;
+        // You need this only if you didn't set 'label' => false in your tags field in TaskType
+        // 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
-        var newForm = prototype.replace(/__name__/g, index);
+        newForm = newForm.replace(/__name__/g, index);
 
         // increase the index with one for the next item
         $collectionHolder.data('index', index + 1);

forms.rst

@@ -639,6 +639,7 @@ the choice is ultimately up to you.
     good idea to explicitly specify the ``data_class`` option by adding the
     following to your form type class::
 
+        // src/AppBundle/Form/TaskType.php
         use AppBundle\Entity\Task;
         use Symfony\Component\OptionsResolver\OptionsResolver;
 

reference/configuration/doctrine.rst

@@ -24,7 +24,7 @@ Full Default Configuration
                         commented:            true
                 # If defined, all the tables whose names match this regular expression are ignored
                 # by the schema tool (in this example, any table name starting with `wp_`)
-                #schema_filter:               "/^wp_/"
+                #schema_filter:               '/^(?!wp_)/'
 
                 connections:
                     # A collection of different named connections (e.g. default, conn2, etc)
@@ -299,9 +299,10 @@ certain classes, but those are for very advanced use-cases only.
 Caching Drivers
 ~~~~~~~~~~~~~~~
 
-For the caching drivers you can specify the values ``array``, ``apc``, ``apcu``,
-``memcache``, ``memcached``, ``redis``, ``wincache``, ``zenddata``, ``xcache``
-or ``service``.
+The built-in types of caching drivers are: ``array``, ``apc``, ``apcu``,
+``memcache``, ``memcached``, ``redis``, ``wincache``, ``zenddata`` and ``xcache``.
+There is a special type called ``service`` which lets you define the ID of your
+own caching service.
 
 The following example shows an overview of the caching configurations:
 
@@ -310,15 +311,17 @@ The following example shows an overview of the caching configurations:
     doctrine:
         orm:
             auto_mapping: true
+            # each caching driver type defines its own config options
             metadata_cache_driver: apc
-            query_cache_driver:
-                type: service
-                id: my_doctrine_common_cache_service
             result_cache_driver:
                 type: memcache
                 host: localhost
                 port: 11211
                 instance_class: Memcache
+            # the 'service' type requires to define the 'id' option too
+            query_cache_driver:
+                type: service
+                id: my_doctrine_common_cache_service
 
 Mapping Configuration
 ~~~~~~~~~~~~~~~~~~~~~

reference/constraints/NotIdenticalTo.rst

@@ -118,6 +118,6 @@ message
 
 **type**: ``string`` **default**: ``This value should not be identical to {{ compared_value_type }} {{ compared_value }}.``
 
-This is the message that will be shown if the value is not equal.
+This is the message that will be shown if the value is identical.
 
 .. include:: /reference/constraints/_payload-option.rst.inc

routing/scheme.rst

@@ -10,6 +10,25 @@ the URI scheme via schemes:
 
 .. configuration-block::
 
+    .. code-block:: php-annotations
+
+        // src/AppBundle/Controller/MainController.php
+        namespace AppBundle\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+        use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
+
+        class MainController extends Controller
+        {
+            /**
+             * @Route("/secure", name="secure", schemes={"https"})
+             */
+            public function secureAction()
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # app/config/routing.yml

security/api_key_authentication.rst

@@ -119,8 +119,11 @@ method, if any.
 
 .. caution::
 
-    In case you return ``null`` from your ``createToken()`` method, be sure to enable
-    ``anonymous`` in you firewall. This way you'll be able to get an ``AnonymousToken``.
+    In case you return ``null`` from your ``createToken()`` method, Symfony
+    passes this request to the next authentication provider. If you haven't
+    configured any other provider, enable the ``anonymous`` option in your
+    firewall. This way Symfony executes the anonymous authentication provider
+    and you'll get an ``AnonymousToken``.
 
 2. supportsToken
 ~~~~~~~~~~~~~~~~

security/remember_me.rst

@@ -241,7 +241,7 @@ In the following example, the action is only allowed if the user has the
 .. code-block:: php
 
     // ...
-    use Symfony\Component\Security\Core\Exception\AccessDeniedException
+    use Symfony\Component\Security\Core\Exception\AccessDeniedException;
 
     // ...
     public function editAction()

service_container/expression_language.rst

@@ -21,7 +21,7 @@ to another service: ``AppBundle\Mailer``. One way to do this is with an expressi
 
     .. code-block:: yaml
 
-        # app/config/config.yml
+        # app/config/services.yml
         services:
             # ...
 
@@ -32,7 +32,7 @@ to another service: ``AppBundle\Mailer``. One way to do this is with an expressi
 
     .. code-block:: xml
 
-        <!-- app/config/config.xml -->
+        <!-- app/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"
@@ -52,12 +52,12 @@ to another service: ``AppBundle\Mailer``. One way to do this is with an expressi
 
     .. code-block:: php
 
-        // app/config/config.php
+        // app/config/services.php
         use AppBundle\Mail\MailerConfiguration;
         use AppBundle\Mailer;
         use Symfony\Component\ExpressionLanguage\Expression;
 
-        $container->autowire(AppBundle\Mail\MailerConfiguration::class);
+        $container->autowire(MailerConfiguration::class);
 
         $container->autowire(Mailer::class)
             ->addArgument(new Expression('service("AppBundle\Mail\MailerConfiguration").getMailerMethod()'));

validation/group_service_resolver.rst

@@ -47,7 +47,7 @@ Then in your form, inject the resolver and set it as the ``validation_groups``.
     namespace AppBundle\Form;
 
     use AppBundle\Validator\ValidationGroupResolver;
-    use Symfony\Component\Form\AbstractType
+    use Symfony\Component\Form\AbstractType;
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
     class MyClassType extends AbstractType

validation/raw_values.rst

@@ -64,7 +64,7 @@ Validation of arrays is possible using the ``Collection`` constraint::
         'password' => new Assert\Length(array('min' => 60)),
     ));
 
-    $violations = $validator->validateValue($input, $constraint);
+    $violations = $validator->validate($input, $constraint);
 
 The ``validate()`` method returns a :class:`Symfony\\Component\\Validator\\ConstraintViolationList`
 object, which acts just like an array of errors. Each error in the collection