feature #7203 Use the new configurator YAML syntax (javiereguiluz)

xabbuh · xabbuh · commit e16a95d9e175 · 2017-04-15T16:48:21.000+02:00
This PR was squashed before being merged into the 3.2 branch (closes #7203). Discussion ---------- Use the new configurator YAML syntax This fixes #7176. Commits ------- 88e30b0 Use the new configurator YAML syntax
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
@@ -127,12 +127,12 @@ You can configure the service configurator using the ``configurator`` option:
             app.newsletter_manager:
                 class:        AppBundle\Mail\NewsletterManager
                 arguments:    ['@mailer']
-                configurator: ['@app.email_configurator', configure]
+                configurator: 'app.email_configurator:configure'
 
             app.greeting_card_manager:
                 class:        AppBundle\Mail\GreetingCardManager
                 arguments:    ['@mailer']
-                configurator: ['@app.email_configurator', configure]
+                configurator: 'app.email_configurator:configure'
 
     .. code-block:: xml
 
@@ -190,6 +190,23 @@ You can configure the service configurator using the ``configurator`` option:
             ->setConfigurator(array(new Reference('app.email_configurator'), 'configure'))
         ;
 
+.. note::
+
+    The traditional configurator syntax in YAML files used an array to define
+    the service id and the method name:
+
+    .. code-block:: yaml
+
+        app.newsletter_manager:
+            # new syntax
+            configurator: 'app.email_configurator:configure'
+            # old syntax
+            configurator: ['@app.email_configurator', configure]
+
+.. versionadded:: 3.2
+    The ``service_id:method_name`` syntax for the YAML configuration format
+    was introduced in Symfony 3.2.
+
 That's it! When requesting the ``app.newsletter_manager`` or
 ``app.greeting_card_manager`` service, the created instance will first be
 passed to the ``EmailConfigurator::configure()`` method.
