ArrayInput
class ArrayInput extends Input
ArrayInput represents an input provided as an array.
Usage:
$input = new ArrayInput(array('name' => 'foo', '--bar' => 'foobar'));
Methods
| __construct(array $parameters, InputDefinition $definition = null) | ||
| bind(InputDefinition $definition) Binds the current Input instance with the given arguments and options. | from Input | |
| validate() Validates the input. | from Input | |
| bool | isInteractive() Is this input means interactive? | from Input |
| setInteractive(bool $interactive) Sets the input interactivity. | from Input | |
| array | getArguments() Returns all the given arguments merged with the default values. | from Input |
| mixed | getArgument(string $name) Returns the argument value for a given argument name. | from Input |
| setArgument(string $name, string $value) Sets an argument value by name. | from Input | |
| bool | hasArgument(string|int $name) Returns true if an InputArgument object exists by name or position. | from Input |
| array | getOptions() Returns all the given options merged with the default values. | from Input |
| mixed | getOption(string $name) Returns the option value for a given option name. | from Input |
| setOption(string $name, string|bool $value) Sets an option value by name. | from Input | |
| bool | hasOption(string $name) Returns true if an InputOption object exists by name. | from Input |
| string | escapeToken(string $token) Escapes a token through escapeshellarg if it contains unsafe chars. | from Input |
| setStream(resource $stream) Sets the input stream to read from when interacting with the user. | from Input | |
| resource|null | getStream() Returns the input stream. | from Input |
| string | getFirstArgument() Returns the first argument from the raw parameters (not parsed). | |
| bool | hasParameterOption(string|array $values, bool $onlyParams = false) Returns true if the raw parameters (not parsed) contain a value. | |
| mixed | getParameterOption(string|array $values, mixed $default = false, bool $onlyParams = false) Returns the value of a raw option (not parsed). | |
| string | __toString() Returns a stringified representation of the args passed to the command. |
Details
__construct(array $parameters, InputDefinition $definition = null)
Parameters
| array | $parameters | |
| InputDefinition | $definition |
bind(InputDefinition $definition)
Binds the current Input instance with the given arguments and options.
Parameters
| InputDefinition | $definition |
validate()
Validates the input.
Exceptions
| RuntimeException | When not enough arguments are given |
bool isInteractive()
Is this input means interactive?
Return Value
| bool |
setInteractive(bool $interactive)
Sets the input interactivity.
Parameters
| bool | $interactive | If the input should be interactive |
array getArguments()
Returns all the given arguments merged with the default values.
Return Value
| array |
mixed getArgument(string $name)
Returns the argument value for a given argument name.
Parameters
| string | $name | The argument name |
Return Value
| mixed | The argument value |
Exceptions
| InvalidArgumentException | When argument given doesn't exist |
setArgument(string $name, string $value)
Sets an argument value by name.
Parameters
| string | $name | The argument name |
| string | $value | The argument value |
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 |
array getOptions()
Returns all the given options merged with the default values.
Return Value
| array |
mixed getOption(string $name)
Returns the option value for a given option name.
Parameters
| string | $name | The option name |
Return Value
| mixed | The option value |
Exceptions
| InvalidArgumentException | When option given doesn't exist |
setOption(string $name, string|bool $value)
Sets an option value by name.
Parameters
| string | $name | The option name |
| string|bool | $value | The option value |
Exceptions
| InvalidArgumentException | When option given doesn't exist |
bool hasOption(string $name)
Returns true if an InputOption object exists by name.
Parameters
| string | $name | The InputOption name |
Return Value
| bool | true if the InputOption object exists, false otherwise |
string escapeToken(string $token)
Escapes a token through escapeshellarg if it contains unsafe chars.
Parameters
| string | $token |
Return Value
| string |
setStream(resource $stream)
Sets the input stream to read from when interacting with the user.
This is mainly useful for testing purpose.
Parameters
| resource | $stream | The input stream |
resource|null getStream()
Returns the input stream.
Return Value
| resource|null |
string getFirstArgument()
Returns the first argument from the raw parameters (not parsed).
Return Value
| string | The value of the first argument or null otherwise |
bool hasParameterOption(string|array $values, bool $onlyParams = false)
Returns true if the raw parameters (not parsed) contain a value.
This method is to be used to introspect the input parameters before they have been validated. It must be used carefully.
Parameters
| string|array | $values | The values to look for in the raw parameters (can be an array) |
| bool | $onlyParams | Only check real parameters, skip those following an end of options (--) signal |
Return Value
| bool | true if the value is contained in the raw parameters |
mixed getParameterOption(string|array $values, mixed $default = false, bool $onlyParams = false)
Returns the value of a raw option (not parsed).
This method is to be used to introspect the input parameters before they have been validated. It must be used carefully.
Parameters
| string|array | $values | The value(s) to look for in the raw parameters (can be an array) |
| mixed | $default | The default value to return if no result is found |
| bool | $onlyParams | Only check real parameters, skip those following an end of options (--) signal |
Return Value
| mixed | The option value |
string __toString()
Returns a stringified representation of the args passed to the command.
Return Value
| string |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.4/Symfony/Component/Console/Input/ArrayInput.html