Spec-Zone.ru › CakePHP 3.6

Класс ProgressHelper

Создайте полосу прогресса, используя предоставленный обратный вызов.

Использование

К ProgressHelper можно получить доступ из оболочек с помощью метода helper()

$this->helper('Progress')->output(['callback' => function ($progress) {
    // Do work
    $progress->increment();
});
Cake\Console\Helper использует Cake\Core\InstanceConfigTrait
Extended by Cake\Shell\Helper\ProgressHelper
Пространство имён: Cake\Shell\Helper
Расположение: Shell/Helper/ProgressHelper.php

Резюме свойств

  • $_progress protected
    integer
    Текущая степень выполнения.
  • $_total protected
    integer
    Общее количество элементов, которые необходимо обработать.
  • $_width protected
    integer
    Ширина полосы.

Наследованные свойства

  • _defaultConfig, _io _config, _configInitialized

Резюме методов

  • 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
Возвращаемое значение, когда ключ не существует.

Возвращает

смешанный тип
Значение конфигурации, которое считывается.
END_OF_DOCUMENT_MARKER

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
При попытке установить недопустимый ключ.

Подробное описание свойств

$_progresssource

protected целое число

Текущий прогресс.

$_totalsource

protected целое число

Общее количество элементов для обработки.

$_widthsource

protected целое число

Ширина полосы.

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API