[DI] add docs for new namespace option

kbond · kbond · commit 70ec5df3aa74 · 2017-08-28T10:04:12.000-04:00
diff --git a/service_container.rst b/service_container.rst
@@ -923,6 +923,34 @@ them will not cause the container to be rebuilt.
     means that all classes are "available to be *used* as services" without needing
     to be manually configured.
 
+The namespace Option
+--------------------
+
+.. versionadded:: 3.4
+    The ``namespace`` option was added in Symfony 3.4.
+
+When using the ``resource`` option in YAML, the namespace prefix can only be used once
+per file when defining it as the ``id``. In order to have multiple definitions in the
+same file with the same namespace prefix, you can use the ``namespace`` option. When
+this option is used, the ``id`` can be anything as long as it is unique. For example,
+you can define your services like this:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # app/config/services.yml
+        services:
+            command_handlers:
+                namespace: App\Domain\
+                resource: ../../src/Domain/*/CommandHandler
+                tags: [command_handler]
+
+            event_subscribers:
+                namespace: App\Domain\
+                resource: ../../src/Domain/*/EventSubscriber
+                tags: [event_subscriber]
+
 .. _services-explicitly-configure-wire-services:
 
 Explicitly Configuring Services and Arguments
