minor #18048 DependencyInjection] Deprecate #[MapDecorated] in favor of #[AutowireDecorated] (mdoutreluingne)

This PR was squashed before being merged into the 6.3 branch.

Discussion
----------

DependencyInjection] Deprecate `#[MapDecorated]` in favor of `#[AutowireDecorated]`

Fixes #18041

Commits
-------

bcf4bec DependencyInjection] Deprecate `#[MapDecorated]` in favor of `#[AutowireDecorated]`

Author: OskarStark

reference/attributes.rst

@@ -34,8 +34,8 @@ Dependency Injection
 * :ref:`Autoconfigure <lazy-services_configuration>`
 * :ref:`AutoconfigureTag <di-instanceof>`
 * :ref:`Autowire <autowire-attribute>`
+* :doc:`AutowireDecorated </service_container/service_decoration>`
 * :ref:`Exclude <service-psr4-loader>`
-* :doc:`MapDecorated </service_container/service_decoration>`
 * :ref:`TaggedIterator <tags_reference-tagged-services>`
 * :ref:`TaggedLocator <service-subscribers-locators_defining-service-locator>`
 * :ref:`Target <autowiring-multiple-implementations-same-type>`

service_container/service_decoration.rst

@@ -150,14 +150,14 @@ automatically changed to ``'.inner'``):
 
         // ...
         use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
-        use Symfony\Component\DependencyInjection\Attribute\MapDecorated;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
 
         #[AsDecorator(decorates: Mailer::class)]
         class DecoratingMailer
         {
             private $inner;
 
-            public function __construct(#[MapDecorated] $inner)
+            public function __construct(#[AutowireDecorated] $inner)
             {
                 $this->inner = $inner;
             }
@@ -215,6 +215,12 @@ automatically changed to ``'.inner'``):
                 ->args([service('.inner')]);
         };
 
+.. deprecated:: 6.3
+
+    The ``#[MapDecorated]`` attribute is deprecated since Symfony 6.3.
+    Instead, use the
+    :class:`#[AutowireDecorated] <Symfony\\Component\\DependencyInjection\\Attribute\\AutowireDecorated>` attribute.
+
 .. tip::
 
     The visibility of the decorated ``App\Mailer`` service (which is an alias
@@ -293,14 +299,14 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
 
             // ...
             use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
-            use Symfony\Component\DependencyInjection\Attribute\MapDecorated;
+            use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
 
             #[AsDecorator(decorates: Foo::class, priority: 5)]
             class Bar
             {
                 private $inner;
 
-                public function __construct(#[MapDecorated] $inner)
+                public function __construct(#[AutowireDecorated] $inner)
                 {
                     $this->inner = $inner;
                 }
@@ -312,7 +318,7 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
             {
                 private $inner;
 
-                public function __construct(#[MapDecorated] $inner)
+                public function __construct(#[AutowireDecorated] $inner)
                 {
                     $this->inner = $inner;
                 }
@@ -616,15 +622,15 @@ Three different behaviors are available:
 
             // ...
             use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
-            use Symfony\Component\DependencyInjection\Attribute\MapDecorated;
+            use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
             use Symfony\Component\DependencyInjection\ContainerInterface;
 
             #[AsDecorator(decorates: Mailer::class, onInvalid: ContainerInterface::IGNORE_ON_INVALID_REFERENCE)]
             class Bar
             {
                 private $inner;
 
-                public function __construct(#[MapDecorated] $inner)
+                public function __construct(#[AutowireDecorated] $inner)
                 {
                     $this->inner = $inner;
                 }

service_container/service_subscribers_locators.rst

@@ -262,7 +262,7 @@ method directly:
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`
-* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\MapDecorated`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireDecorated`
 
 This is done by having ``getSubscribedServices()`` return an array of
 :class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService` objects
@@ -865,7 +865,7 @@ of the following dependency injection attributes:
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`
-* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\MapDecorated`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireDecorated`
 
 Here's an example::