Class ProgressHelper
Create a progress bar using a supplied callback.
- Cake\Console\Helper uses Cake\Core\InstanceConfigTrait
- Cake\Shell\Helper\ProgressHelper
Method Detail
incrementsource public
increment( integer $num 1 )
Increment the progress bar.
Parameters
- integer
$num
optional 1 - The amount of progress to advance by.
initsource public
init( array $args [] )
Initialize the progress bar for use.
-
total
The total number of items in the progress bar. Defaults to 100. -
width
The width of the progress bar. Defaults to 80.
Parameters
- array
$args
optional [] - The initialization data.
outputsource public
output( array $args )
Output a progress bar.
Takes a number of options to customize the behavior:
-
total
The total number of items in the progress bar. Defaults to 100. -
width
The width of the progress bar. Defaults to 80. -
callback
The callback that will be called in a loop to advance the progress bar.
Parameters
- array
$args
- The arguments/options to use when outputing the progress bar.
Methods inherited from Cake\Console\Helper
__constructsource public
__construct( Cake\Console\ConsoleIo $io , array $config [] )
Constructor.
Parameters
-
Cake\Console\ConsoleIo
$io
- The ConsoleIo instance to use.
- array
$config
optional [] - The settings for this helper.
Methods used from Cake\Core\InstanceConfigTrait
_configDeletesource protected
_configDelete( string $key )
Delete a single config key
Parameters
- string
$key
- Key to delete.
Throws
Cake\Core\Exception\Exception
if attempting to clobber existing config
_configReadsource protected
_configRead( string|null $key )
Read a config variable
Parameters
- string|null
$key
- Key to read.
Returns
mixed
mixed
_configWritesource protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Write a config variable
Parameters
- string|array
$key
- Key to write to.
- mixed
$value
- Value to write.
- boolean|string
$merge
optional false - True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.
Throws
Cake\Core\Exception\Exception
if attempting to clobber existing config
configsource public
config( string|array|null $key null , mixed|null $value null , boolean $merge true )
Usage
Reading the whole config:
$this->config();
Reading a specific value:
$this->config('key');
Reading a nested value:
$this->config('some.nested.key');
Setting a specific value:
$this->config('key', $value);
Setting a nested value:
$this->config('some.nested.key', $value);
Updating multiple config settings at the same time:
$this->config(['one' => 'value', 'another' => 'value']);
Parameters
- string|array|null
$key
optional null - The key to get/set, or a complete array of configs.
- mixed|null
$value
optional null - The value to set.
- boolean
$merge
optional true - Whether to recursively merge or overwrite existing config, defaults to true.
Returns
mixed
Config value being read, or the object itself on write operations.
Throws
Cake\Core\Exception\Exception
When trying to set a key that is invalid.
configShallowsource public
configShallow( string|array $key , mixed|null $value null )
Merge provided config with existing config. Unlike config()
which does a recursive merge for nested keys, this method does a simple merge.
Setting a specific value:
$this->config('key', $value);
Setting a nested value:
$this->config('some.nested.key', $value);
Updating multiple config settings at the same time:
$this->config(['one' => 'value', 'another' => 'value']);
Parameters
- string|array
$key
- The key to set, or a complete array of configs.
- mixed|null
$value
optional null - The value to set.
Returns
mixed
$this The object itself.
Properties summary
Properties inherited from Cake\Console\Helper
Properties used from Cake\Core\InstanceConfigTrait
$_configInitializedsource
protected boolean
Whether the config property has already been configured with defaults
false
© 2005–2016 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.
http://api.cakephp.org/3.1/class-Cake.Shell.Helper.ProgressHelper.html