feature #17920 [DependencyInjection] AsAlias attribute (SzymonKaminski)

OskarStark · OskarStark · commit f6d8add165a1 · 2023-02-20T15:52:26.000+01:00
This PR was squashed before being merged into the 6.3 branch. Discussion ---------- [DependencyInjection] `AsAlias` attribute This PR aims to resolve #17916. Commits ------- f3c3168 [DependencyInjection] `AsAlias` attribute
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
@@ -95,6 +95,20 @@ services.
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/Mail/PhpMailer.php
+        namespace App\Mail;
+
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsAlias;
+
+        #[AsAlias(id: 'app.mailer', public: true)]
+        class PhpMailer
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -139,6 +153,10 @@ services.
             $services->alias('app.mailer', PhpMailer::class);
         };
 
+.. versionadded:: 6.3
+
+    The ``#[AsAlias]`` attribute was introduced in Symfony 6.3.
+
 This means that when using the container directly, you can access the
 ``PhpMailer`` service by asking for the ``app.mailer`` service like this::
 
@@ -155,6 +173,25 @@ This means that when using the container directly, you can access the
             # ...
             app.mailer: '@App\Mail\PhpMailer'
 
+.. tip::
+
+    When using ``#[AsAlias]`` attribute, you may omit passing ``id`` argument
+    if the class implements exactly one interface. ``MailerInterface`` will be
+    alias of ``PhpMailer``::
+
+        // src/Mail/PhpMailer.php
+        namespace App\Mail;
+
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsAlias;
+        use Symfony\Component\Mailer\MailerInterface;
+
+        #[AsAlias]
+        class PhpMailer implements MailerInterface
+        {
+            // ...
+        }
+
 Deprecating Service Aliases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
