Document the ability to set aliases and hidden status via command name

OskarStark · OskarStark · commit fee6f46c49d5 · 2025-07-01T10:52:30.000+02:00
- Add separate documentation sections for command aliases and hidden commands
- Document the pipe syntax to define command aliases
- Document how to make commands hidden using the `|` prefix
- Show examples for the #[AsCommand] attribute
- Include separate version annotations for Symfony 7.4 for each feature
- Ensure lines are within 80 character limit
diff --git a/console.rst b/console.rst
@@ -240,6 +240,51 @@ You can register the command by adding the ``AsCommand`` attribute to it::
         // ...
     }
 
+You can also define aliases directly in the command name using a pipe (``|``)
+separator::
+
+    use Symfony\Component\Console\Attribute\AsCommand;
+    use Symfony\Component\Console\Command\Command;
+
+    #[AsCommand(
+        name: 'app:create-user|app:add-user|app:new-user',
+        description: 'Creates a new user.',
+    )]
+    class CreateUserCommand extends Command
+    {
+        // ...
+    }
+
+.. versionadded:: 7.4
+
+    The ability to define aliases through the command name was introduced in
+    Symfony 7.4.
+
+When using the pipe syntax, the first name in the list defines the command name,
+the others are aliases.
+
+To create a hidden command, start the name with a pipe (``|``)::
+
+    use Symfony\Component\Console\Attribute\AsCommand;
+    use Symfony\Component\Console\Command\Command;
+
+    #[AsCommand(
+        name: '|app:create-user',
+        description: 'Creates a new user.',
+    )]
+    class CreateUserCommand extends Command
+    {
+        // ...
+    }
+
+.. versionadded:: 7.4
+
+    The ability to define hidden commands through the command name was
+    introduced in Symfony 7.4.
+
+When the first name is empty (starts with ``|``), the command is marked as
+hidden.
+
 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>`,
diff --git a/console/hide_commands.rst b/console/hide_commands.rst
@@ -23,8 +23,25 @@ the ``hidden`` property of the ``AsCommand`` attribute::
         // ...
     }
 
-Hidden commands behave the same as normal commands but they are no longer displayed
-in command listings, so end-users are not aware of their existence.
+You can also define a command as hidden using the pipe (``|``) syntax in the
+command name::
+
+    use Symfony\Component\Console\Attribute\AsCommand;
+    use Symfony\Component\Console\Command\Command;
+
+    #[AsCommand(name: '|app:legacy')]
+    class LegacyCommand extends Command
+    {
+        // ...
+    }
+
+.. versionadded:: 7.4
+
+    The ability to define a command as hidden using the pipe syntax in the
+    command name was introduced in Symfony 7.4.
+
+Hidden commands behave the same as normal commands but they are no longer
+displayed in command listings, so end-users are not aware of their existence.
 
 .. note::
 
