Spec-Zone.ru › CakePHP 3.4

Класс 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 )

Увеличение прогресса полосы.

Параметры

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
Значение конфигурации, которое считывается.
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–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

Spec-Zone.ru

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