climate/terminal-objects/progress-bar.md

---

layout: default title: Progress Bar

permalink: /terminal-objects/progress-bar/

Progress Bar

Easily add a progress bar to your output:

$progress = $climate->progress()->total(100);

for ($i = 0; $i <= 100; $i++) {
  $progress->current($i);

  // Simulate something happening
  usleep(80000);
}

Which will result in:

You can also shorthand it a bit if you'd like and pass the total right into the progress method:

$climate->progress(100);

Manually Advancing

You can also manually advance the bar:

$progress = $climate->progress()->total(100);

// Do something

$progress->advance(); // Adds 1 to the current progress

// Do something

$progress->advance(10); // Adds 10 to the current progress

// Do something

$progress->advance(5, 'Still going.'); // Adds 5, displays a label

Labels

If you'd like a more descriptive indicator of where you are in the process, pass a label into the current method:

$languages = [
    'php',
    'javascript',
    'python',
    'ruby',
    'java',
];

$progress = $climate->progress()->total(count($languages));

foreach ($languages as $key => $language) {
  $progress->current($key + 1, $language);

  // Simulate something happening
  usleep(80000);
}