Skip to content

How to Hide Console Commands

Warning: You are browsing the documentation for Symfony 3.x, which is no longer maintained.

Read the updated version of this page for Symfony 7.2 (the current stable version).

By default, all console commands are listed when executing the console application script without arguments or when using the list command.

However, sometimes commands are not intended to be executed by end-users; for example, commands for the legacy parts of the application, commands exclusively executed through scheduled tasks, etc.

In those cases, you can define the command as hidden by setting the setHidden() method to true in the command configuration:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// src/AppBundle/Command/LegacyCommand.php
namespace AppBundle\Command;

use Symfony\Component\Console\Command\Command;

class LegacyCommand extends Command
{
    protected static $defaultName = 'app:legacy';

    protected function configure()
    {
        $this
            ->setHidden(true)
            // ...
        ;
    }
}

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

Hidden commands are still available using the JSON or XML descriptor.

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.
TOC
    Version