PHP - CLI Progress Bar

Below is the code for a progress bar that you can use in your PHP-based CLI applications. Adding this to your long-running applications can let you know if you have time to go have lunch or grab a covfefe.

<?php

/**
 * Display a progress bar in the CLI. This will dynamically take up the full width of the 
 * terminal and if you keep calling this function, it will appear animated as the progress bar
 * keeps writing over the top of itself.
 * @param float $percentage - the percentage completed.
 * @param int $numDecimalPlaces - the number of decimal places to show for percentage output string
 */
function showProgressBar($percentage, int $numDecimalPlaces)
{
    $percentageStringLength = 4;
    if ($numDecimalPlaces > 0)
    {
        $percentageStringLength += ($numDecimalPlaces + 1);
    }

    $percentageString = number_format($percentage, $numDecimalPlaces) . '%';
    $percentageString = str_pad($percentageString, $percentageStringLength, " ", STR_PAD_LEFT);

    $percentageStringLength += 3; // add 2 for () and a space before bar starts.

    $terminalWidth = `tput cols`;
    $barWidth = $terminalWidth - ($percentageStringLength) - 2; // subtract 2 for [] around bar
    $numBars = round(($percentage) / 100 * ($barWidth));
    $numEmptyBars = $barWidth - $numBars;

    $barsString = '[' . str_repeat("=", ($numBars)) . str_repeat(" ", ($numEmptyBars)) . ']';

    echo "($percentageString) " . $barsString . "\r";
}

# demonstrate the progress bar working.
$total=4535;
for ($i=0; $i<$total; $i++)
{
    $percentage = $i / $total * 100;
    showProgressBar($percentage, 2);
}

print PHP_EOL;
print "done!" . PHP_EOL;

Demonstration Video