minor #17652 [DependencyInjection] Autowire arguments using the #[TaggedIterator] attribute (alexandre-daubois)

javiereguiluz · javiereguiluz · commit 375c481f64a8 · 2023-01-05T16:18:35.000+01:00
This PR was merged into the 5.4 branch. Discussion ---------- [DependencyInjection] Autowire arguments using the #[TaggedIterator] attribute Partially solves #15238. As tagged locator are not mentioned here, I guess it should be done somewhere else. Commits ------- 0db7228 [DependencyInjection] Autowire arguments using the #[TaggedIterator] attribute
diff --git a/service_container/tags.rst b/service_container/tags.rst
@@ -591,6 +591,26 @@ application handlers::
         }
     }
 
+Injecting tagged services can be also be done through autowiring thanks to the
+``#[TaggedIterator]`` attribute. This attribute must be directly used on the
+argument to autowire::
+
+    // src/HandlerCollection.php
+    namespace App;
+
+    use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+
+    class HandlerCollection
+    {
+        public function __construct(#[TaggedIterator('app.handler')] iterable $handlers)
+        {
+        }
+    }
+
+.. versionadded:: 5.3
+
+    The ``#[TaggedIterator]`` attribute was introduced in Symfony 5.3 and requires PHP 8.
+
 .. seealso::
 
     See also :doc:`tagged locator services </service_container/service_subscribers_locators>`
