Merge branch '6.0' into 6.1

javiereguiluz · javiereguiluz · commit eaf27f70de44 · 2022-02-09T09:28:33.000+01:00
* 6.0:
  [Console] Document AsCommand attribute
diff --git a/console.rst b/console.rst
@@ -132,8 +132,28 @@ available in the ``configure()`` method::
 Registering the Command
 -----------------------
 
-Symfony commands must be registered as services and :doc:`tagged </service_container/tags>`
-with the ``console.command`` tag. If you're using the
+In PHP 8 and newer versions, you can register the command by adding the
+``AsCommand`` attribute to it::
+
+    // src/Command/CreateUserCommand.php
+    namespace App\Command;
+
+    use Symfony\Component\Console\Attribute\AsCommand;
+    use Symfony\Component\Console\Command\Command;
+
+    #[AsCommand(
+        name: 'app:create-user',
+        description: 'Creates a new user.',
+        hidden: false,
+        aliases: ['app:add-user']
+    )]
+    class CreateUserCommand extends Command
+    {
+        // ...
+    }
+
+If you can't use PHP attributes, register the command as a service and
+:doc:`tag it </service_container/tags>` with the ``console.command`` tag. If you're using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
 
