Merge branch '2.8' into 3.4

javiereguiluz · javiereguiluz · commit 177c84a67532 · 2018-06-27T09:53:12.000+02:00
* 2.8:
  Add section about anonymous services
  Add iterable to the Type constraint
  Added a note about hidden questions, windows and tests
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
@@ -382,3 +382,9 @@ This way you can test any user interaction (even complex ones) by passing the ap
     The :class:`Symfony\\Component\\Console\\Tester\\CommandTester` automatically
     simulates a user hitting ``ENTER`` after each input, no need for passing
     an additional input.
+
+.. caution::
+
+    On Windows systems Symfony uses a special binary to implement hidden
+    questions. This means that those questions don't use the default ``Input``
+    console object and therefore you can't test them on Windows.
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
@@ -125,6 +125,7 @@ datatypes as determined by PHP's ``is_()`` functions.
 * :phpfunction:`double <is_double>`
 * :phpfunction:`int <is_int>`
 * :phpfunction:`integer <is_integer>`
+* :phpfunction:`iterable <is_iterable>`
 * :phpfunction:`long <is_long>`
 * :phpfunction:`null <is_null>`
 * :phpfunction:`numeric <is_numeric>`
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
@@ -144,6 +144,38 @@ This means that when using the container directly, you can access the
             # ...
             app.mailer: '@AppBundle\Mail\PhpMailer'
 
+Anonymous Services
+------------------
+
+.. note::
+
+    Anonymous services are only supported by the XML configuration format.
+
+In some cases, you may want to prevent a service being used as a dependency of
+other services. This can be achieved by creating an anonymous service. These
+services are like regular services but they don't define an ID and they are
+created where they are used.
+
+The following example shows how to inject an anonymous service into another service:
+
+.. code-block:: 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"
+        xsi:schemaLocation="http://symfony.com/schema/dic/services
+            http://symfony.com/schema/dic/services/services-1.0.xsd">
+
+        <services>
+            <service id="foo" class="AppBundle\Foo">
+                <argument type="service">
+                    <service class="AppBundle\AnonymousBar" />
+                </argument>
+            </service>
+        </services>
+    </container>
+
 Deprecating Services
 --------------------
 
