PseudoRandom

The PseudoRandom component provides fast pseudo-random number generation using PHP's Mersenne Twister engine (mt_rand). It is appropriate for non-security contexts such as shuffling, sampling, simulations, or any case where speed matters more than cryptographic guarantees.

Important: Do not use PseudoRandom for tokens, passwords, keys, or anything security-related. Use SecureRandom instead.

Usage

Random Integers

Generate a pseudo-random integer within a range:

use Psl\IO;
use Psl\PseudoRandom;

$roll = PseudoRandom\int(1, 6);
IO\write_line('Dice roll: %d', $roll);

// Full 64-bit range by default
$value = PseudoRandom\int();
IO\write_line('Random value: %d', $value);

Random Floats

Generate a pseudo-random float between 0.0 and 1.0:

use Psl\IO;
use Psl\PseudoRandom;

$chance = PseudoRandom\float();
IO\write_line('Random chance: %f', $chance);

if ($chance < 0.3) {
    IO\write_line('Hit the 30%% probability branch!');
} else {
    IO\write_line('Missed the 30%% probability branch.');
}

When to Use PseudoRandom vs SecureRandom

See src/Psl/PseudoRandom/ for the full API.