Installation

Creating a Console Application

First, you need to create a PHP script to define the console application:

Then, you can register the commands using addCommand():

You can also register inline commands and define their behavior thanks to the Command::setCode() method:

This is useful when creating a single-command application.

See the Console Commands article for information about how to create commands.

Using a PSR Container

The Application class accepts an optional third argument, a PSR-11 ContainerInterface. When provided, the application automatically wires several services from the container:

• event_dispatcher: sets the event dispatcher via setDispatcher()
• console.argument_resolver: sets the argument resolver via setArgumentResolver()
• console.command_loader: sets the command loader via setCommandLoader()
• console.command.ids: eagerly loads commands registered in the container
• services_resetter: resets services after run() completes

When using Symfony's ContainerInterface, the kernel.environment and kernel.debug parameters are also displayed in the application's long version output.

This makes it possible to build console applications with dependency injection without requiring HttpKernel or FrameworkBundle. Passing no container preserves all existing behavior:

Using the ConsoleBundle

Building the container by hand as shown above works, but the Console component also provides a ConsoleBundle that brings service autodiscovery, autoconfiguration and autowiring to console applications, still without requiring HttpKernel or FrameworkBundle.

The bundle needs a kernel to build the container. Use the kernel provided by the DependencyInjection component (read Building HTTP-less Applications for more details):

Then, enable the bundle:

Finally, create the console executable. This example uses the Runtime component, but you can also boot the kernel yourself:

The kernel follows the same conventions as full Symfony applications: config/bundles.php to enable bundles, config/packages/ to configure them and config/services.yaml (or config/services.php) to register your own services and commands.

On top of that, ConsoleBundle provides the following:

• autoconfiguration for commands: any service extending Command or using the #[AsCommand] attribute is added to the application and loaded lazily through the command loader;
• autoconfiguration for the argument value resolvers, together with all the built-in resolvers;
• a listener that logs command errors and non-zero exit codes, when the EventDispatcher component is installed;
• the dotenv:debug command, when the Dotenv component is installed.

ConsoleBundle declares ServicesBundle as a required bundle, so you don't need to enable it yourself. That bundle provides the core services used by the container, such as parameter_bag, event_dispatcher, filesystem and clock.

Learn more