run the closure sometimes, a percentage of the time

sometimes.php

<?php

if (!function_exists('sometimes')) {
    /**
     * Executes a callback a given percentage of the time.
     *
     * @param int $percentage The percentage of times the callback should run (0-100).
     * @param callable $callback The closure to execute.
     * @param mixed|callable|null $default The value to return if the callback is not executed.
     *                                     If it's a Closure, it will be invoked.
     * @return mixed The result of the callback if executed, otherwise the default value.
     */
    function sometimes(int $percentage, callable $callback, $default = null)
    {
        if (random_int(1, 100) <= $percentage) {
            return $callback();
        }

        return $default instanceof Closure ? $default() : $default;
    }
}

// Example Test:
$runCount = 0;
$totalIterations = 1000000;
$percentage = 25;

for ($i = 0; $i < $totalIterations; $i++) {
    if (sometimes($percentage, fn() => true)) {
        $runCount++;
    }
}

echo "The callback was executed approximately " . ($runCount / $totalIterations) * 100 . "% of the time.";