DialogHelper deprecated
class DialogHelper extends InputAwareHelper
deprecated
Класс Dialog предоставляет вспомогательные методы для взаимодействия с пользователем.
Methods
| 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 |
| static | removeDecoration(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() Возвращает каноническое имя этого помощника. |
Details
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 |
static removeDecoration(OutputFormatterInterface $formatter, $string)
Параметры
| OutputFormatterInterface | $formatter | |
| $string |
setInput(InputInterface $input)
Устанавливает вход Console.
Параметры
| 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 | Максимальное количество попыток, прежде чем отказаться (по умолчанию false, что означает бесконечное количество) |
| 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 | Максимальное количество попыток, прежде чем отказаться (по умолчанию false, что означает бесконечное количество) |
| 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 | Максимальное количество попыток, прежде чем отказаться (по умолчанию false, что означает бесконечное количество) |
| 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/2.7/Symfony/Component/Console/Helper/DialogHelper.html