Spec-Zone.ru › CakePHP 3.8

Класс ProgressHelper

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

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

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

$this->helper('Progress')->output(['callback' => function ($progress) {
    // Do work
    $progress->increment();
});
Cake\Console\Helper использует Cake\Core\InstanceConfigTrait
Расширяется 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

Истина для рекурсивного слияния, «поверхностное» для простого слияния, ложь для перезаписи, по умолчанию ложь.

Исключения

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, если ключ не существует.
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.8/class-Cake.Shell.Helper.ProgressHelper.html

Spec-Zone.ru

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