feature #17695 [DependencyInjection] Add #[Autoconfigure] and #[AutoconfigureTag] documentation (alexandre-daubois)

OskarStark · OskarStark · commit cd9e68a69ad4 · 2023-01-10T14:16:51.000+01:00
This PR was merged into the 5.4 branch. Discussion ---------- [DependencyInjection] Add `#[Autoconfigure]` and `#[AutoconfigureTag]` documentation Closes #14990 Part of #17563 Commits ------- ce16301 [DependencyInjection] Add #[Autoconfigure] and #[AutoconfigureTag] documentation
diff --git a/service_container/tags.rst b/service_container/tags.rst
@@ -117,6 +117,29 @@ If you want to apply tags automatically for your own services, use the
                     ->tag('app.custom_tag');
         };
 
+It is also possible to use the ``#[AutoconfigureTag]`` attribute directly on the
+base class or interface::
+
+    // src/Security/CustomInterface.php
+    namespace App\Security;
+
+    use Symfony\Component\DependencyInjection\Attribute\AutoconfigureTag;
+
+    #[AutoconfigureTag('app.custom_tag')]
+    interface CustomInterface
+    {
+        // ...
+    }
+
+.. tip::
+
+    If you need more capabilities to autoconfigure instances of your base class
+    like their laziness, their bindings or their calls for example, you may rely
+    on the :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute.
+
+.. versionadded:: 5.3
+
+    The ``#[Autoconfigure]`` and ``#[AutoconfigureTag]`` attributes were introduced in Symfony 5.3.
 
 For more advanced needs, you can define the automatic tags using the
 :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerForAutoconfiguration` method.
