ProgressBar
class ProgressBar
ProgressBar предоставляет помощники для отображения выходных данных о ходе выполнения.
Методы
| __construct(OutputInterface $output, int $max) | ||
| static | setPlaceholderFormatterDefinition(string $name, callable $callable) Устанавливает форматтер заполнителей для заданного имени. | |
| static callable|null | getPlaceholderFormatterDefinition(string $name) Возвращает форматтер заполнителей для заданного имени. | |
| static | setFormatDefinition(string $name, string $format) Устанавливает формат для заданного имени. | |
| static string|null | getFormatDefinition(string $name) Возвращает формат для заданного имени. | |
| setMessage(string $message, string $name = 'message') Связывает текст с заполнителем заданного имени. | ||
| getMessage($name = 'message') | ||
| int | getStartTime() Возвращает время начала прогресс-бара. | |
| int | getMaxSteps() Возвращает максимальное количество шагов прогресс-бара. | |
| int | getProgress() Возвращает текущую позицию шага. | |
| float | getProgressPercent() Возвращает текущий процент прогресс-бара. | |
| setBarWidth(int $size) Устанавливает ширину прогресс-бара. | ||
| int | getBarWidth() Возвращает ширину прогресс-бара. | |
| setBarCharacter(string $char) Устанавливает символ прогресс-бара. | ||
| string | getBarCharacter() Возвращает символ прогресс-бара. | |
| setEmptyBarCharacter(string $char) Устанавливает символ пустой части прогресс-бара. | ||
| string | getEmptyBarCharacter() Возвращает символ пустой части прогресс-бара. | |
| setProgressCharacter(string $char) Устанавливает символ заполненной части прогресс-бара. | ||
| string | getProgressCharacter() Возвращает символ заполненной части прогресс-бара. | |
| setFormat(string $format) Устанавливает формат прогресс-бара. | ||
| setRedrawFrequency(int|float $freq) Устанавливает частоту перерисовки. | ||
| start(int|null $max = null) Инициализирует вывод прогресс-бара. | ||
| advance(int $step = 1) Увеличивает прогресс-бар на X шагов. | ||
| setOverwrite(bool $overwrite) Устанавливает, нужно ли перезаписывать прогресс-бар (false - новая строка). | ||
| setProgress(int $step) Устанавливает текущий прогресс. | ||
| finish() Завершает вывод прогресс-бара. | ||
| display() Выводит текущую строку прогресса. | ||
| clear() Удаляет прогресс-бар из текущей строки. |
Подробное описание
__construct(OutputInterface $output, int $max)
Параметры
| OutputInterface | $output | Экземпляр OutputInterface |
| int | $max | Максимальное количество шагов (0, если неизвестно) |
static setPlaceholderFormatterDefinition(string $name, callable $callable)
Устанавливает форматтер плейсхолдеров для заданного имени.
Этот метод также позволяет переопределить существующий плейсхолдер.
Параметры
| string | $name | Имя плейсхолдера (включая разделитель, например %) |
| callable | $callable | PHP вызываемый объект |
static callable|null getPlaceholderFormatterDefinition(string $name)
Получает форматтер плейсхолдеров для заданного имени.
Параметры
| string | $name | Имя плейсхолдера (включая разделитель, например %) |
Возвращаемое значение
| callable|null | PHP вызываемый объект |
static setFormatDefinition(string $name, string $format)
Устанавливает формат для заданного имени.
Этот метод также позволяет переопределить существующий формат.
Параметры
| string | $name | Имя формата |
| string | $format | Строка формата |
static string|null getFormatDefinition(string $name)
Получает формат для заданного имени.
Параметры
| string | $name | Имя формата |
Возвращаемое значение
| string|null | Строка формата |
setMessage(string $message, string $name = 'message')
Связывает текст с именованным плейсхолдером.
Текст отображается при отрисовке полосы прогресса, но только если соответствующий плейсхолдер является частью строки пользовательского формата (обернув имя в %).
Параметры
| string | $message | Текст для ассоциации с плейсхолдером |
| string | $name | Имя плейсхолдера |
getMessage($name = 'message')
Параметры
| $name |
int getStartTime()
Получает время начала полосы прогресса.
Возвращаемое значение
| int | Время начала полосы прогресса |
int getMaxSteps()
Получает максимальное количество шагов полосы прогресса.
Возвращаемое значение
| int | Максимальное количество шагов полосы прогресса |
int getProgress()
Получает текущую позицию шага.
Возвращаемое значение
| int | Текущий шаг полосы прогресса |
float getProgressPercent()
Получает текущий процент полосы прогресса.
Возвращаемое значение
| float | Текущий процент полосы прогресса |
setBarWidth(int $size)
Устанавливает ширину полосы прогресса.
Параметры
| int | $size | Размер полосы прогресса |
int getBarWidth()
Получает ширину полосы прогресса.
Возвращаемое значение
| int | Размер полосы прогресса |
setBarCharacter(string $char)
Устанавливает символ полосы прогресса.
Параметры
| string | $char | Символ |
string getBarCharacter()
Получает символ полосы прогресса.
Возвращаемое значение
| string | Символ |
setEmptyBarCharacter(string $char)
Устанавливает символ пустой полосы прогресса.
Параметры
| string | $char | Символ |
string getEmptyBarCharacter()
Получает символ пустой полосы прогресса.
Возвращаемое значение
| string | Символ |
setProgressCharacter(string $char)
Устанавливает символ текущего шага полосы прогресса.
Параметры
| string | $char | Символ |
string getProgressCharacter()
Получает символ текущего шага полосы прогресса.
Возвращаемое значение
| string | Символ |
setFormat(string $format)
Устанавливает формат полосы прогресса.
Параметры
| string | $format | Формат |
setRedrawFrequency(int|float $freq)
Устанавливает частоту перерисовки.
Параметры
| int|float | $freq | Частота в шагах |
start(int|null $max = null)
Запускает вывод полосы прогресса.
Параметры
| int|null | $max | Количество шагов для завершения полосы (0, если неопределено), null, чтобы оставить без изменений |
advance(int $step = 1)
Перемещает полосу прогресса на X шагов вперед.
Параметры
| int | $step | Количество шагов, на которое нужно переместиться вперед |
setOverwrite(bool $overwrite)
Устанавливает, нужно ли перезаписывать полосу прогресса, false для новой строки.
Параметры
| bool | $overwrite |
setProgress(int $step)
Устанавливает текущий прогресс.
Параметры
| int | $step | Текущий прогресс |
finish()
Завершает вывод полосы прогресса.
display()
Выводит текущую строку прогресса.
clear()
Удаляет полосу прогресса из текущей строки.
Это полезно, если вы хотите вывести некоторые данные, пока полоса прогресса работает. Используйте display(), чтобы снова показать полосу прогресса.
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.2/Symfony/Component/Console/Helper/ProgressBar.html