Building a single Command Application
Warning: You are browsing the documentation for Symfony 2.x, which is no longer maintained.
Read the updated version of this page for Symfony 7.1 (the current stable version).
When building a command line tool, you may not need to provide several commands. In such case, having to pass the command name each time is tedious. Fortunately, it is possible to remove this need by extending the application:
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 39 40 41 42 43 44 45 46 47 48 49
namespace Acme\Tool;
use Symfony\Component\Console\Application;
use Symfony\Component\Console\Input\InputInterface;
class MyApplication extends Application
{
/**
* Gets the name of the command based on input.
*
* @param InputInterface $input The input interface
*
* @return string The command name
*/
protected function getCommandName(InputInterface $input)
{
// This should return the name of your command.
return 'my_command';
}
/**
* Gets the default commands that should always be available.
*
* @return array An array of default Command instances
*/
protected function getDefaultCommands()
{
// Keeps the core default commands to have the HelpCommand
// which is used when using the --help option
$defaultCommands = parent::getDefaultCommands();
$defaultCommands[] = new MyCommand();
return $defaultCommands;
}
/**
* Overridden so that the application doesn't expect the command
* name to be the first argument.
*/
public function getDefinition()
{
$inputDefinition = parent::getDefinition();
// clears out the normal first argument, which is the command name
$inputDefinition->setArguments();
return $inputDefinition;
}
}
When calling your console script, the command MyCommand
will then always
be used, without having to pass its name.
You can also simplify how you execute the application:
1 2 3 4 5 6 7 8
#!/usr/bin/env php
<?php
// command.php
use Acme\Tool\MyApplication;
$application = new MyApplication();
$application->run();