How to Define Commands as Services
Edit this pageWarning: You are browsing the documentation for Symfony 2.4, which is no longer maintained.
Read the updated version of this page for Symfony 6.1 (the current stable version).
How to Define Commands as Services
2.4
Support for registering commands in the service container was introduced in Symfony 2.4.
By default, Symfony will take a look in the Command directory of each
bundle and automatically register your commands. If a command extends the
ContainerAwareCommand,
Symfony will even inject the container.
While making life easier, this has some limitations:
- Your command must live in the
Commanddirectory; - There's no way to conditionally register your service based on the environment or availability of some dependencies;
- You can't access the container in the
configure()method (becausesetContainerhasn't been called yet); - You can't use the same class to create many commands (i.e. each with different configuration).
To solve these problems, you can register your command as a service and tag it
with console.command:
- YAML
- XML
- PHP
1 2 3 4 5 6
# app/config/config.yml
services:
acme_hello.command.my_command:
class: Acme\HelloBundle\Command\MyCommand
tags:
- { name: console.command }Using Dependencies and Parameters to Set Default Values for Options
Imagine you want to provide a default value for the name option. You could
pass one of the following as the 5th argument of addOption():
- a hardcoded string;
- a container parameter (e.g. something from parameters.yml);
- a value computed by a service (e.g. a repository).
By extending ContainerAwareCommand, only the first is possible, because you
can't access the container inside the configure() method. Instead, inject
any parameter or service you need into the constructor. For example, suppose you
have some NameRepository service that you'll use to get your default value:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
// src/Acme/DemoBundle/Command/GreetCommand.php
namespace Acme\DemoBundle\Command;
use Acme\DemoBundle\Entity\NameRepository;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;
class GreetCommand extends Command
{
protected $nameRepository;
public function __construct(NameRepository $nameRepository)
{
$this->nameRepository = $nameRepository;
parent::__construct();
}
protected function configure()
{
$defaultName = $this->nameRepository->findLastOne();
$this
->setName('demo:greet')
->setDescription('Greet someone')
->addOption('name', '-n', InputOption::VALUE_REQUIRED, 'Who do you want to greet?', $defaultName)
;
}
protected function execute(InputInterface $input, OutputInterface $output)
{
$name = $input->getOption('name');
$output->writeln($name);
}
}Now, just update the arguments of your service configuration like normal to
inject the NameRepository. Great, you now have a dynamic default value!
Caution
Be careful not to actually do any work in configure (e.g. make database
queries), as your code will be run, even if you're using the console to
execute a different command.
