ArgvInput
class ArgvInput extends Input
ArgvInput представляет входные данные, полученные из аргументов командной строки.
Использование:
$input = new ArgvInput();
По умолчанию используется массив $_SERVER['argv'] для значений ввода.
Это можно переопределить, явно передав значения ввода в конструктор:
$input = new ArgvInput($_SERVER['argv']);
Если вы передаете их сами, не забудьте, что первый элемент массива — это имя запускаемого приложения.
При передаче аргумента в конструктор, убедитесь, что он соответствует тем же правилам, что и argv. Практически всегда лучше использовать StringInput, когда вы хотите предоставить собственные входные данные.
Методы
| __construct(array $argv = null, InputDefinition $definition = null) Конструктор. | ||
| bind(InputDefinition $definition) Связывает текущий экземпляр Input с заданными аргументами и опциями. | из Input | |
| validate() Проверяет входные данные. | из Input | |
| bool | isInteractive() Является ли этот ввод интерактивным? | из Input |
| setInteractive(bool $interactive) Устанавливает интерактивность ввода. | из Input | |
| array | getArguments() Возвращает все заданные аргументы, объединённые со значениями по умолчанию. | из Input |
| mixed | getArgument(string $name) Возвращает значение аргумента для заданного имени аргумента. | из Input |
| setArgument(string $name, string $value) Устанавливает значение аргумента по имени. | из Input | |
| bool | hasArgument(string|int $name) Возвращает true, если объект InputArgument существует по имени или позиции. | из Input |
| array | getOptions() Возвращает все заданные опции, объединённые со значениями по умолчанию. | из Input |
| mixed | getOption(string $name) Возвращает значение опции для заданного имени опции. | из Input |
| setOption(string $name, string|bool $value) Устанавливает значение опции по имени. | из Input | |
| bool | hasOption(string $name) Возвращает true, если объект InputOption существует по имени. | из Input |
| string | escapeToken(string $token) Экранирует токен с помощью escapeshellarg, если он содержит небезопасные символы. | из Input |
| string | 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 $argv = null, InputDefinition $definition = null)
Конструктор.
Параметры
| array | $argv | Массив параметров из командной строки (в формате argv) |
| InputDefinition | $definition | Экземпляр InputDefinition |
bind(InputDefinition $definition)
Связывает текущий экземпляр Input с заданными аргументами и опциями.
Параметры
| InputDefinition | $definition | Экземпляр InputDefinition |
validate()
Проверяет входные данные.
Исключения
| RuntimeException | При недостаточном количестве аргументов |
bool isInteractive()
Является ли этот ввод интерактивным?
Возвращаемое значение
| bool |
setInteractive(bool $interactive)
Устанавливает интерактивность ввода.
Параметры
| bool | $interactive | Если ввод должен быть интерактивным |
array getArguments()
Возвращает все заданные аргументы, объединённые со значениями по умолчанию.
Возвращаемое значение
| array |
mixed getArgument(string $name)
Возвращает значение аргумента для заданного имени аргумента.
Параметры
| string | $name | Имя аргумента |
Возвращаемое значение
| mixed | Значение аргумента |
Исключения
| InvalidArgumentException | Если заданный аргумент не существует |
setArgument(string $name, string $value)
Устанавливает значение аргумента по имени.
Параметры
| string | $name | Имя аргумента |
| string | $value | Значение аргумента |
Исключения
| InvalidArgumentException | Если заданный аргумент не существует |
bool hasArgument(string|int $name)
Возвращает true, если объект InputArgument существует по имени или позиции.
Параметры
| string|int | $name | Имя или позиция InputArgument |
Возвращаемое значение
| bool | true, если объект InputArgument существует, иначе false |
array getOptions()
Возвращает все заданные опции, объединённые со значениями по умолчанию.
Возвращаемое значение
| array |
mixed getOption(string $name)
Возвращает значение опции для заданного имени опции.
Параметры
| string | $name | Имя опции |
Возвращаемое значение
| mixed | Значение опции |
Исключения
| InvalidArgumentException | Если заданная опция не существует |
setOption(string $name, string|bool $value)
Устанавливает значение опции по имени.
Параметры
| string | $name | Имя опции |
| string|bool | $value | Значение опции |
Исключения
| InvalidArgumentException | Если заданная опция не существует |
bool hasOption(string $name)
Возвращает true, если объект InputOption существует по имени.
Параметры
| string | $name | Имя InputOption |
Возвращаемое значение
| bool | true, если объект InputOption существует, иначе false |
string escapeToken(string $token)
Экранирует токен через escapeshellarg, если он содержит небезопасные символы.
Параметры
| string | $token |
Возвращаемое значение
| string |
string getFirstArgument()
Возвращает первый аргумент из исходных параметров (не обработанных).
Возвращаемое значение
| string | Значение первого аргумента или 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.
http://api.symfony.com/3.1/Symfony/Component/Console/Input/ArgvInput.html
