ArrayInput
class ArrayInput extends Input
ArrayInput представляет входные данные, предоставленные в виде массива.
Использование:
$input = new ArrayInput(array('name' => 'foo', '--bar' => 'foobar'));
Свойства
| protected | $definition | from Input | |
| protected | $stream | from Input | |
| protected | $options | from Input | |
| protected | $arguments | from Input | |
| protected | $interactive | from Input |
Методы
| __construct(array $parameters, InputDefinition $definition = null) | ||
| bind(InputDefinition $definition) Связывает текущий экземпляр Input с заданными аргументами и опциями. | from Input | |
| parse() Обрабатывает аргументы командной строки. | ||
| validate() Проверяет входные данные. | from Input | |
| bool | isInteractive() Являются ли эти входные данные интерактивными? | from Input |
| setInteractive(bool $interactive) Устанавливает интерактивность ввода. | from Input | |
| array | getArguments() Возвращает все заданные аргументы, объединенные со значениями по умолчанию. | from Input |
| string|string[]|null | getArgument(string $name) Возвращает значение аргумента для заданного имени аргумента. | from Input |
| setArgument(string $name, string|string[]|null $value) Устанавливает значение аргумента по имени. | from Input | |
| bool | hasArgument(string|int $name) Возвращает true, если объект InputArgument существует по имени или позиции. | from Input |
| array | getOptions() Возвращает все заданные опции, объединенные со значениями по умолчанию. | from Input |
| string|string[]|bool|null | getOption(string $name) Возвращает значение опции для заданного имени опции. | from Input |
| setOption(string $name, string|string[]|bool|null $value) Устанавливает значение опции по имени. | from Input | |
| bool | hasOption(string $name) Возвращает true, если объект InputOption существует по имени. | from Input |
| string | escapeToken(string $token) Экранирует токен с помощью escapeshellarg, если он содержит небезопасные символы. | from Input |
| setStream(resource $stream) Устанавливает поток ввода для чтения при взаимодействии с пользователем. | from Input | |
| resource|null | getStream() Возвращает поток ввода. | from Input |
| string|null | getFirstArgument() Возвращает первый аргумент из исходных параметров (не обработанных). | |
| bool | hasParameterOption(string|array $values, bool $onlyParams = false) Возвращает true, если исходные параметры (не обработанные) содержат значение. | |
| mixed | getParameterOption(string|array $values, mixed $default = false, bool $onlyParams = false) Возвращает значение исходной опции (не обработанной). | |
| string | __toString() Возвращает строковое представление аргументов, переданных команде. |
Подробности
__construct(array $parameters, InputDefinition $definition = null)
Параметры
| array | $parameters | |
| InputDefinition | $definition |
bind(InputDefinition $definition)
Связывает текущий экземпляр Input с заданными аргументами и опциями.
Параметры
| InputDefinition | $definition |
Исключения
| RuntimeException |
protected parse()
Обрабатывает аргументы командной строки.
validate()
Проверяет входные данные.
Исключения
| RuntimeException | При недостаточном количестве аргументов |
bool isInteractive()
Является ли этот ввод интерактивным?
Значение возврата
| bool |
setInteractive(bool $interactive)
Устанавливает интерактивность ввода.
Параметры
| bool | $interactive | Если ввод должен быть интерактивным |
array getArguments()
Возвращает все заданные аргументы, объединённые со значениями по умолчанию.
Значение возврата
| array |
string|string[]|null getArgument(string $name)
Возвращает значение аргумента для данного имени аргумента.
Параметры
| string | $name | Имя аргумента |
Значение возврата
| string|string[]|null | Значение аргумента |
Исключения
| InvalidArgumentException | Если заданный аргумент не существует |
setArgument(string $name, string|string[]|null $value)
Устанавливает значение аргумента по имени.
Параметры
| string | $name | Имя аргумента |
| string|string[]|null | $value | Значение аргумента |
Исключения
| InvalidArgumentException | Если заданный аргумент не существует |
bool hasArgument(string|int $name)
Возвращает true, если объект InputArgument существует по имени или позиции.
Параметры
| string|int | $name | Имя или позиция InputArgument |
Значение возврата
| bool | true, если объект InputArgument существует, иначе false |
array getOptions()
Возвращает все заданные опции, объединённые со значениями по умолчанию.
Значение возврата
| array |
string|string[]|bool|null getOption(string $name)
Возвращает значение опции для данного имени опции.
Параметры
| string | $name | Имя опции |
Значение возврата
| string|string[]|bool|null | Значение опции |
Исключения
| InvalidArgumentException | Если заданная опция не существует |
setOption(string $name, string|string[]|bool|null $value)
Устанавливает значение опции по имени.
Параметры
| string | $name | Имя опции |
| string|string[]|bool|null | $value | Значение опции |
Исключения
| InvalidArgumentException | Если заданная опция не существует |
bool hasOption(string $name)
Возвращает true, если объект InputOption существует по имени.
Параметры
| string | $name | Имя InputOption |
Значение возврата
| bool | true, если объект InputOption существует, иначе false |
string escapeToken(string $token)
Экранирует маркер с помощью escapeshellarg, если он содержит небезопасные символы.
Параметры
| string | $token |
Значение возврата
| string |
setStream(resource $stream)
Устанавливает входной поток для чтения при взаимодействии с пользователем.
Это в основном полезно для целей тестирования.
Параметры
| resource | $stream | Входной поток |
resource|null getStream()
Возвращает входной поток.
Значение возврата
| resource|null |
string|null getFirstArgument()
Возвращает первый аргумент из исходных параметров (не разобранных).
Значение возврата
| string|null | Значение первого аргумента или null в противном случае |
bool hasParameterOption(string|array $values, bool $onlyParams = false)
Возвращает true, если исходные параметры (не разобранные) содержат значение.
Этот метод предназначен для инспектирования входных параметров до их проверки. Его следует использовать осторожно. Возможно, он не вернёт правильный результат для коротких опций, когда несколько флагов объединены в одной опции.
Параметры
| string|array | $values | Искомые значения в исходных параметрах (может быть массивом) |
| bool | $onlyParams | Проверять только реальные параметры, пропускать те, которые следуют за сигналом окончания опций (--) |
Значение возврата
| bool | true, если значение содержится в исходных параметрах |
mixed getParameterOption(string|array $values, mixed $default = false, bool $onlyParams = false)
Возвращает значение исходной опции (не разобранной).
Этот метод предназначен для инспектирования входных параметров до их проверки. Его следует использовать осторожно. Возможно, он не вернёт правильный результат для коротких опций, когда несколько флагов объединены в одной опции.
Параметры
| string|array | $values | Искомое(ые) значение(я) в исходных параметрах (может быть массивом) |
| mixed | $default | Значение по умолчанию, возвращаемое, если результат не найден |
| bool | $onlyParams | Проверять только реальные параметры, пропускать те, которые следуют за сигналом окончания опций (--) |
Значение возврата
| mixed | Значение опции |
string __toString()
Возвращает строковое представление аргументов, переданных команде.
Значение возврата
| string |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/Console/Input/ArrayInput.html