Класс 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 Истина для рекурсивного слияния, «поверхностное» для простого слияния, ложь для перезаписи, по умолчанию ложь.
Исключения
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 - Выполнять ли рекурсивное слияние или перезапись существующей конфигурации, по умолчанию истина.
Возвращает
смешанный типЗначение конфигурации, которое читается, или сам объект при операциях записи.
Исключения
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 - Значение, которое возвращается, если ключ не существует.
Возвращает
смешанный типДанные конфигурации по указанному ключу или 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.8/class-Cake.Shell.Helper.ProgressHelper.html