InputDefinition
class InputDefinition
A InputDefinition represents a set of valid command line arguments and options.
Usage:
$definition = new InputDefinition(array(
new InputArgument('name', InputArgument::REQUIRED),
new InputOption('foo', 'f', InputOption::VALUE_REQUIRED),
));
Methods
| __construct(array $definition = array()) | ||
| setDefinition(array $definition) Sets the definition of the input. | ||
| setArguments(InputArgument[] $arguments = array()) Sets the InputArgument objects. | ||
| addArguments(InputArgument[] $arguments = array()) Adds an array of InputArgument objects. | ||
| addArgument(InputArgument $argument) | ||
| InputArgument | getArgument(string|int $name) Returns an InputArgument by name or by position. | |
| bool | hasArgument(string|int $name) Returns true if an InputArgument object exists by name or position. | |
| InputArgument[] | getArguments() Gets the array of InputArgument objects. | |
| int | getArgumentCount() Returns the number of InputArguments. | |
| int | getArgumentRequiredCount() Returns the number of required InputArguments. | |
| array | getArgumentDefaults() Gets the default values. | |
| setOptions(InputOption[] $options = array()) Sets the InputOption objects. | ||
| addOptions(InputOption[] $options = array()) Adds an array of InputOption objects. | ||
| addOption(InputOption $option) | ||
| InputOption | getOption(string $name) Returns an InputOption by name. | |
| bool | hasOption(string $name) Returns true if an InputOption object exists by name. | |
| InputOption[] | getOptions() Gets the array of InputOption objects. | |
| bool | hasShortcut(string $name) Returns true if an InputOption object exists by shortcut. | |
| InputOption | getOptionForShortcut(string $shortcut) Gets an InputOption by shortcut. | |
| array | getOptionDefaults() Gets an array of default values. | |
| string | getSynopsis(bool $short = false) Gets the synopsis. |
Details
__construct(array $definition = array())
Parameters
| array | $definition | An array of InputArgument and InputOption instance |
setDefinition(array $definition)
Sets the definition of the input.
Parameters
| array | $definition |
setArguments(InputArgument[] $arguments = array())
Sets the InputArgument objects.
Parameters
| InputArgument[] | $arguments | An array of InputArgument objects |
addArguments(InputArgument[] $arguments = array())
Adds an array of InputArgument objects.
Parameters
| InputArgument[] | $arguments | An array of InputArgument objects |
addArgument(InputArgument $argument)
Parameters
| InputArgument | $argument |
Exceptions
| LogicException | When incorrect argument is given |
InputArgument getArgument(string|int $name)
Returns an InputArgument by name or by position.
Parameters
| string|int | $name | The InputArgument name or position |
Return Value
| InputArgument | An InputArgument object |
Exceptions
| InvalidArgumentException | When argument given doesn't exist |
bool hasArgument(string|int $name)
Returns true if an InputArgument object exists by name or position.
Parameters
| string|int | $name | The InputArgument name or position |
Return Value
| bool | true if the InputArgument object exists, false otherwise |
InputArgument[] getArguments()
Gets the array of InputArgument objects.
Return Value
| InputArgument[] | An array of InputArgument objects |
int getArgumentCount()
Returns the number of InputArguments.
Return Value
| int | The number of InputArguments |
int getArgumentRequiredCount()
Returns the number of required InputArguments.
Return Value
| int | The number of required InputArguments |
array getArgumentDefaults()
Gets the default values.
Return Value
| array | An array of default values |
setOptions(InputOption[] $options = array())
Sets the InputOption objects.
Parameters
| InputOption[] | $options | An array of InputOption objects |
addOptions(InputOption[] $options = array())
Adds an array of InputOption objects.
Parameters
| InputOption[] | $options | An array of InputOption objects |
addOption(InputOption $option)
Parameters
| InputOption | $option |
Exceptions
| LogicException | When option given already exist |
InputOption getOption(string $name)
Returns an InputOption by name.
Parameters
| string | $name | The InputOption name |
Return Value
| InputOption | A InputOption object |
Exceptions
| InvalidArgumentException | When option given doesn't exist |
bool hasOption(string $name)
Returns true if an InputOption object exists by name.
This method can't be used to check if the user included the option when executing the command (use getOption() instead).
Parameters
| string | $name | The InputOption name |
Return Value
| bool | true if the InputOption object exists, false otherwise |
InputOption[] getOptions()
Gets the array of InputOption objects.
Return Value
| InputOption[] | An array of InputOption objects |
bool hasShortcut(string $name)
Returns true if an InputOption object exists by shortcut.
Parameters
| string | $name | The InputOption shortcut |
Return Value
| bool | true if the InputOption object exists, false otherwise |
InputOption getOptionForShortcut(string $shortcut)
Gets an InputOption by shortcut.
Parameters
| string | $shortcut | The Shortcut name |
Return Value
| InputOption | An InputOption object |
array getOptionDefaults()
Gets an array of default values.
Return Value
| array | An array of all default values |
string getSynopsis(bool $short = false)
Gets the synopsis.
Parameters
| bool | $short | Whether to return the short version (with options folded) or not |
Return Value
| string | The synopsis |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/Console/Input/InputDefinition.html