Contributed by
Jérôme Vasseur
in #29753.
The common workflow for Symfony Console progress bars is to start them, advance them according to your task progress and finish them:
1 2 3 4 5 6 7 8 9 10 | use Symfony\Component\Console\Helper\ProgressBar;
$progressBar = new ProgressBar($output);
$progressBar->start();
// ... do some work
$progressBar->advance();
// needed to ensure that the bar reaches 100%
$progressBar->finish();
|
In Symfony 4.3 we've improved this workflow when you work with iterable
variables (such as arrays or generators). Thanks to the new iterate()
method, you can pass the iterable variable and the progress bar starts, advances
and finishes automatically.
Consider the following simple PHP generator:
1 2 3 4 5 | $iterable = function () {
yield 1;
yield 2;
// ...
};
|
You can turn this into a progress bar as follows:
1 2 3 4 5 6 7 | use Symfony\Component\Console\Helper\ProgressBar;
$progressBar = new ProgressBar($output);
foreach ($progressBar->iterate($iterable) as $value) {
// ... do some work
}
|
The output in your terminal will be the following:
1 2 3 | 0/2 [>---------------------------] 0%
1/2 [==============>-------------] 50%
2/2 [============================] 100%
|
What a Symfony developer should know about the framework: News, Jobs, Tweets, Events, Videos,...