Класс ProgressHelper
Создаёт полосу прогресса с использованием предоставленного обратного вызова.
Использование
К ProgressHelper можно получить доступ из оболочек с помощью метода helper()
$this->helper('Progress')->output(['callback' => function ($progress) {
// Do work
$progress->increment();
}); - Cake\Console\Helper использует Cake\Core\InstanceConfigTrait
-
Cake\Shell\Helper\ProgressHelper
Краткое описание свойств
-
$_progressprotectedТекущий прогресс.integer -
$_totalprotectedОбщее количество 'элементов', по которым идёт прогресс.integer -
$_widthprotectedШирина полосы.integer
Унаследованные свойства
Краткое описание методов
- draw() publicОтображение полосы прогресса на основе текущего состояния.
- increment() publicУвеличение прогресса полосы.
- init() publicИнициализация полосы прогресса для использования.
- output() publicВывод полосы прогресса.
Подробное описание методов
draw()source public
draw( )
Отображение полосы прогресса на основе текущего состояния.
Возвращаемое значение
$this
increment()source public
increment( integer $num 1 )
Увеличение прогресса полосы.
Параметры
- integer
$numдополнительно 1 - Величина увеличения прогресса.
Возвращаемое значение
$this
init()source public
init( array $args [] )
Инициализация полосы прогресса для использования.
-
totalОбщее количество элементов в полосе прогресса. По умолчанию 100. -
widthШирина полосы прогресса. По умолчанию 80.
Параметры
- array
$argsдополнительно [] - Данные инициализации.
Возвращаемое значение
$this
output()source public
output( array $args )
Вывод полосы прогресса.
Принимает ряд опций для настройки поведения:
-
totalОбщее количество элементов в полосе прогресса. По умолчанию 100. -
widthШирина полосы прогресса. По умолчанию 80. -
callbackОбратный вызов, который будет вызываться в цикле для продвижения полосы прогресса.
Параметры
- array
$args - Аргументы/опции для использования при выводе полосы прогресса.
Методы, унаследованные от Cake\Console\Helper
__construct()source public
__construct( Cake\Console\ConsoleIo $io , array $config [] )
Конструктор.
Параметры
-
Cake\Console\ConsoleIo$io - Экземпляр ConsoleIo для использования.
- array
$configдополнительно [] - Настройки для данного помощника.
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаляет единственный ключ конфигурации.
Параметры
- string
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
_configRead()source protected
_configRead( string|null $key )
Считывает ключ конфигурации.
Параметры
- string|null
$key - Ключ для чтения.
Возвращаемое значение
mixed_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Записывает ключ конфигурации.
Параметры
- string|array
$key - Ключ для записи.
- mixed
$value - Значение для записи.
- boolean|string
$mergeдополнительно false Истина для рекурсивного слияния, 'shallow' для простого слияния, ложь для перезаписи, по умолчанию ложь.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
config()source public
config( string|array|null $key null , mixed|null $value null , boolean $merge true )
Получение/Установка конфигурации.
Использование
Чтение всей конфигурации:
$this->config();
Чтение определённого значения:
$this->config('key'); Чтение вложенного значения:
$this->config('some.nested.key'); Установка определённого значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Устарело
3.4.0 используйте setConfig()/getConfig() вместо этого.Параметры
- string|array|null
$keyдополнительно null - Ключ для получения/установки, или полный массив конфигураций.
- mixed|null
$valueдополнительно null - Значение для установки.
- boolean
$mergeдополнительно true - Выполнять ли рекурсивное слияние или перезапись существующей конфигурации, по умолчанию истинно.
Возвращаемое значение
mixedЗначение конфигурации, которое считывается, или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value null )
Объединяет предоставленную конфигурацию с существующей. В отличие от config(), которое выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.
Установка определённого значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки, или полный массив конфигураций.
- mixed|null
$valueдополнительно null - Значение для установки.
Возвращаемое значение
$this
getConfig()source public
getConfig( string|null $key null , mixed $default null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определённого значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- string|null
$keyдополнительно null - Ключ для получения или null для всей конфигурации.
- mixed
$defaultдополнительно null - Возвращаемое значение, когда ключ не существует.
Возвращаемое значение
mixedЗначение конфигурации, которое считывается.
setConfig()source public
setConfig( string|array $key , mixed|null $value null , boolean $merge true )
Устанавливает конфигурацию.
Использование
Установка определенного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или полный массив настроек.
- смешанное|null
$valueнеобязательно null - Значение для установки.
- логическое
$mergeнеобязательно true - Флаг рекурсивного слияния или перезаписи существующей конфигурации, по умолчанию true.
Возвращает
$this
Выбрасывает
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Подробное описание свойств
© 2005–2017 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.4/class-Cake.Shell.Helper.ProgressHelper.html