DialogHelper deprecated
class DialogHelper extends InputAwareHelper
deprecated
Класс Dialog предоставляет помощники для взаимодействия с пользователем.
Методы
| setHelperSet(HelperSet $helperSet = null) Устанавливает набор помощников, связанных с этим помощником. | from Helper | |
| HelperSet | getHelperSet() Возвращает набор помощников, связанных с этим помощником. | from Helper |
| static int | strlen(string $string) Возвращает длину строки, используя mb_strwidth, если он доступен. | from Helper |
| static | formatTime($secs) | from Helper |
| static | formatMemory($memory) | from Helper |
| static | strlenWithoutDecoration(OutputFormatterInterface $formatter, $string) | from Helper |
| setInput(InputInterface $input) Устанавливает вход Console. | from InputAwareHelper | |
| __construct($triggerDeprecationError = true) | ||
| int|string|array | select(OutputInterface $output, string|array $question, array $choices, bool|string $default = null, bool|int $attempts = false, string $errorMessage = 'Value "%s" is invalid', bool $multiselect = false) Запрашивает у пользователя выбор значения. | |
| string | ask(OutputInterface $output, string|array $question, string $default = null, array $autocomplete = null) Задает вопрос пользователю. | |
| bool | askConfirmation(OutputInterface $output, string|array $question, bool $default = true) Запрашивает подтверждение у пользователя. | |
| string | askHiddenResponse(OutputInterface $output, string|array $question, bool $fallback = true) Задает вопрос пользователю, ответ скрыт. | |
| mixed | askAndValidate(OutputInterface $output, string|array $question, callable $validator, int|false $attempts = false, string $default = null, array $autocomplete = null) Запрашивает значение и проверяет ответ. | |
| string | askHiddenResponseAndValidate(OutputInterface $output, string|array $question, callable $validator, int|false $attempts = false, bool $fallback = true) Запрашивает значение, скрывает и проверяет ответ. | |
| setInputStream(resource $stream) Устанавливает поток ввода для чтения при взаимодействии с пользователем. | ||
| resource|null | getInputStream() Возвращает поток ввода помощника. | |
| string | getName() Возвращает каноническое имя этого помощника. |
Подробности
setHelperSet(HelperSet $helperSet = null)
Устанавливает набор помощников, связанных с этим помощником.
Параметры
| HelperSet | $helperSet | Экземпляр HelperSet |
HelperSet getHelperSet()
Получает набор помощников, связанных с этим помощником.
Значение возврата
| HelperSet | Экземпляр HelperSet |
static int strlen(string $string)
Возвращает длину строки, используя mb_strwidth, если она доступна.
Параметры
| string | $string | Строка, для которой нужно проверить длину |
Значение возврата
| int | Длина строки |
static formatTime($secs)
Параметры
| $secs |
static formatMemory($memory)
Параметры
| $memory |
static strlenWithoutDecoration(OutputFormatterInterface $formatter, $string)
Параметры
| OutputFormatterInterface | $formatter | |
| $string |
setInput(InputInterface $input)
Устанавливает входные данные консоли.
Параметры
| InputInterface | $input |
__construct($triggerDeprecationError = true)
Параметры
| $triggerDeprecationError |
int|string|array select(OutputInterface $output, string|array $question, array $choices, bool|string $default = null, bool|int $attempts = false, string $errorMessage = 'Value "%s" is invalid', bool $multiselect = false)
Запрашивает у пользователя выбор значения.
Параметры
| OutputInterface | $output | Экземпляр Output |
| string|array | $question | Вопрос для пользователя |
| array | $choices | Список вариантов для выбора |
| bool|string | $default | Значение по умолчанию, если пользователь ничего не вводит |
| bool|int | $attempts | Максимальное количество попыток, прежде чем отказаться (по умолчанию — бесконечно) |
| string | $errorMessage | Сообщение, которое будет показано, если пользователь выберет некорректное значение из списка |
| bool | $multiselect | Выбирать несколько значений, разделенных запятой |
Значение возврата
| int|string|array | Выбранное значение или значения (ключ массива choices) |
Исключения
| InvalidArgumentException |
string ask(OutputInterface $output, string|array $question, string $default = null, array $autocomplete = null)
Задает вопрос пользователю.
Параметры
| OutputInterface | $output | Экземпляр Output |
| string|array | $question | Вопрос для пользователя |
| string | $default | Ответ по умолчанию, если пользователь ничего не вводит |
| array | $autocomplete | Список значений для автозаполнения |
Значение возврата
| string | Ответ пользователя |
Исключения
| RuntimeException | Если в потоке ввода нет данных для чтения |
bool askConfirmation(OutputInterface $output, string|array $question, bool $default = true)
Запрашивает подтверждение у пользователя.
Вопрос будет задаваться до тех пор, пока пользователь не ответит ничего, да или нет.
Параметры
| OutputInterface | $output | Экземпляр Output |
| string|array | $question | Вопрос для пользователя |
| bool | $default | Ответ по умолчанию, если пользователь ничего не вводит |
Значение возврата
| bool | true, если пользователь подтвердил, иначе false |
string askHiddenResponse(OutputInterface $output, string|array $question, bool $fallback = true)
Задает вопрос пользователю, ответ скрыт.
Параметры
| OutputInterface | $output | Экземпляр Output |
| string|array | $question | Вопрос |
| bool | $fallback | В случае, если ответ нельзя скрыть, следует ли перейти к нескрытому вопросу |
Значение возврата
| string | Ответ |
Исключения
| RuntimeException | В случае, если отказ от скрытия ответа не активирован, и ответ нельзя скрыть |
mixed askAndValidate(OutputInterface $output, string|array $question, callable $validator, int|false $attempts = false, string $default = null, array $autocomplete = null)
Запрашивает значение и проверяет ответ.
Валидатор получает данные для проверки. Он должен возвращать проверенные данные, если данные валидны, и вызывать исключение в противном случае.
Параметры
| OutputInterface | $output | Экземпляр Output |
| string|array | $question | Вопрос для пользователя |
| callable | $validator | PHP-обратный вызов |
| int|false | $attempts | Максимальное количество попыток, прежде чем отказаться (по умолчанию — бесконечно) |
| string | $default | Ответ по умолчанию, если пользователь ничего не вводит |
| array | $autocomplete | Список значений для автозаполнения |
Значение возврата
| mixed |
Исключения
| Exception | Если любой из валидаторов возвращает ошибку |
string askHiddenResponseAndValidate(OutputInterface $output, string|array $question, callable $validator, int|false $attempts = false, bool $fallback = true)
Запрашивает значение, скрывает и проверяет ответ.
Валидатор получает данные для проверки. Он должен возвращать проверенные данные, если данные валидны, и вызывать исключение в противном случае.
Параметры
| OutputInterface | $output | Экземпляр Output |
| string|array | $question | Вопрос для пользователя |
| callable | $validator | PHP-обратный вызов |
| int|false | $attempts | Максимальное количество попыток, прежде чем отказаться (по умолчанию — бесконечно) |
| bool | $fallback | В случае, если ответ нельзя скрыть, следует ли перейти к нескрытому вопросу |
Значение возврата
| string | Ответ |
Исключения
| Exception | Если любой из валидаторов возвращает ошибку |
| RuntimeException | В случае, если отказ от скрытия ответа не активирован, и ответ нельзя скрыть |
setInputStream(resource $stream)
Устанавливает поток ввода для чтения при взаимодействии с пользователем.
Это полезно в основном для целей тестирования.
Параметры
| resource | $stream | Поток ввода |
resource|null getInputStream()
Возвращает входной поток помощника.
Значение возврата
| resource|null | Входной поток или null, если используется стандартный STDIN |
string getName()
Возвращает каноническое имя этого помощника.
Значение возврата
| string | Каноническое имя |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.2/Symfony/Component/Console/Helper/DialogHelper.html