Spec-Zone.ru › CakePHP 3.5

Класс 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–2018 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.5/class-Cake.Shell.Helper.ProgressHelper.html

Spec-Zone.ru

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