minor #19814 [DependencyInjection] Clarify the #[Target] attribute 2 (HypeMC)

javiereguiluz · javiereguiluz · commit 35d808dc7ef0 · 2024-06-24T12:39:28.000+02:00
This PR was squashed before being merged into the 6.4 branch. Discussion ---------- [DependencyInjection] Clarify the `#[Target]` attribute 2 Follow-up to #19789, adds a [paragraph](bd00116) about the `debug:autowiring` command. Commits ------- 81cc7f0 [DependencyInjection] Clarify the `#[Target]` attribute 2
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
@@ -549,13 +549,35 @@ Another option is to use the ``#[Target]`` attribute. By adding this attribute
 to the argument you want to autowire, you can specify which service to inject by
 passing the name of the argument used in the named alias. This way, you can have
 multiple services implementing the same interface and keep the argument name
-separate from any implementation name (like shown in the example above).
+separate from any implementation name (like shown in the example above). In addition,
+you'll get an exception in case you make any typo in the target name.
 
 .. warning::
 
     The ``#[Target]`` attribute only accepts the name of the argument used in the
     named alias; it **does not** accept service ids or service aliases.
 
+You can get a list of named autowiring aliases by running the ``debug:autowiring`` command::
+
+.. code-block:: terminal
+
+    $ php bin/console debug:autowiring LoggerInterface
+
+    Autowirable Types
+    =================
+
+     The following classes & interfaces can be used as type-hints when autowiring:
+     (only showing classes/interfaces matching LoggerInterface)
+
+     Describes a logger instance.
+     Psr\Log\LoggerInterface - alias:monolog.logger
+     Psr\Log\LoggerInterface $assetMapperLogger - target:asset_mapperLogger - alias:monolog.logger.asset_mapper
+     Psr\Log\LoggerInterface $cacheLogger - alias:monolog.logger.cache
+     Psr\Log\LoggerInterface $httpClientLogger - target:http_clientLogger - alias:monolog.logger.http_client
+     Psr\Log\LoggerInterface $mailerLogger - alias:monolog.logger.mailer
+
+     [...]
+
 Suppose you want to inject the ``App\Util\UppercaseTransformer`` service. You would use
 the ``#[Target]`` attribute by passing the name of the ``$shoutyTransformer`` argument::
 
