[DI][HttpKernel] document Autowire attribute

Author: kbond

controller.rst

@@ -153,7 +153,7 @@ and ``redirect()`` methods::
 
         // redirects to a route and maintains the original query string parameters
         return $this->redirectToRoute('blog_show', $request->query->all());
-        
+
         // redirects to the current route (e.g. for Post/Redirect/Get pattern):
         return $this->redirectToRoute($request->attributes->get('_route'));
 
@@ -286,6 +286,45 @@ in your controllers.
 
 For more information about services, see the :doc:`/service_container` article.
 
+Autowire Parameter Attribute
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.1
+
+    The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
+
+Services that cannot be autowired, :ref:`parameters <service-parameters>` and even
+:doc:`complex expressions </service_container/expression_language>` can be bound
+to a controller argument with the ``#[Autowire]`` attribute::
+
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
+
+    /**
+     * @Route("/lucky/number/{max}")
+     */
+    public function number(
+        int $max,
+
+        #[Autowire('@monolog.logger.request')]
+        LoggerInterface $logger,
+
+        #[Autowire('%kernel.project_dir%/data')]
+        string $dataDir,
+
+        #[Autowire('%kernel.debug%')]
+        bool $debugMode,
+
+        #[Autowire("@=service("App\\Mail\\MailerConfiguration").getMailerMethod()")]
+        string $mailerMethod,
+    ): Response
+    {
+        $logger->info('We are logging!');
+        // ...
+    }
+
 Generating Controllers
 ----------------------
 

service_container.rst

@@ -684,6 +684,56 @@ For a full list of *all* possible services in the container, run:
 
 .. _services-binding:
 
+Autowire Parameter Attribute
+----------------------------
+
+.. versionadded:: 6.1
+
+    The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
+
+For services that cannot be autowired, you can use the ``#[Autowire]`` parameter
+attribute to explicitly configure the service::
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            #[Autowire('@monolog.logger.request')] private LoggerInterface $logger
+        ) {
+        }
+        // ...
+    }
+
+The ``#[Autowire]`` can also be used for :ref:`parameters <service-parameters>` and even
+:doc:`complex expressions </service_container/expression_language>`::
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            #[Autowire('%kernel.project_dir%/data')]
+            private string $dataDir,
+
+            #[Autowire('%kernel.debug%')]
+            private bool $debugMode,
+
+            #[Autowire("@=service("App\\Mail\\MailerConfiguration").getMailerMethod()")]
+            private string $mailerMethod,
+        ) {
+        }
+        // ...
+    }
+
 Binding Arguments by Name or Type
 ---------------------------------