Класс 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 )
Увеличение степени выполнения полосы прогресса.
Параметры
- целое число
$numнеобязательно 1 - Величина увеличения степени выполнения.
Возвращает
$this
init()source public
init( array $args = [] )
Инициализация полосы прогресса для использования.
-
totalОбщее количество элементов в полосе прогресса. По умолчанию 100. -
widthШирина полосы прогресса. По умолчанию 80.
Параметры
- массив
$argsнеобязательно [] - Данные инициализации.
Возвращает
$this
output()source public
output( array $args )
Вывод полосы прогресса.
Принимает ряд параметров для настройки поведения:
-
totalОбщее количество элементов в полосе прогресса. По умолчанию 100. -
widthШирина полосы прогресса. По умолчанию 80. -
callbackОбратный вызов, который будет вызываться в цикле для продвижения полосы прогресса.
Параметры
- массив
$args - Аргументы/параметры для использования при выводе полосы прогресса.
Методы, унаследованные от Cake\Console\Helper
__construct()source public
__construct( Cake\Console\ConsoleIo $io , array $config = [] )
Конструктор.
Параметры
-
Cake\Console\ConsoleIo$io - Экземпляр ConsoleIo для использования.
- массив
$configнеобязательно [] - Настройки для этого помощника.
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаляет один ключ конфигурации.
Параметры
- строка
$key - Ключ для удаления.
Выбрасывает
Cake\Core\Exception\Exceptionпри попытке перезаписать существующую конфигурацию
_configRead()source protected
_configRead( string|null $key )
Считывает значение ключа конфигурации.
Параметры
- строка|null
$key - Ключ для считывания.
Возвращает
смешанный тип_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge = false )
Записывает значение ключа конфигурации.
Параметры
- строка|массив
$key - Ключ для записи.
- смешанный тип
$value - Значение для записи.
- логическое значение|строка
$mergeнеобязательно false True для рекурсивной слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Выбрасывает
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
config()source public deprecated
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() вместо этого.Параметры
- строка|массив|null
$keyнеобязательно null - Ключ для получения/установки, или полный массив конфигураций.
- смешанный тип|null
$valueнеобязательно null - Значение для установки.
- логическое значение
$mergeнеобязательно true - Выполнять рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
смешанный типЗначение конфигурации, которое считывается, или сам объект при операциях записи.
Выбрасывает
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']);
Параметры
- строка|массив
$key - Ключ для установки, или полный массив конфигураций.
- смешанный тип|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'); Параметры
- строка|null
$keyнеобязательно null - Ключ для получения или null для всей конфигурации.
- смешанный тип
$defaultнеобязательно null - Возвращаемое значение, когда ключ не существует.
Возвращает
смешанный типЗначение конфигурации, которое считывается.
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–present 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.6/class-Cake.Shell.Helper.ProgressHelper.html