WireRandom

• alphanumeric() / alpha() / numeric() — tokens, slugs, short IDs; crypto-secure by default.
• string() — when you need a specific character set (hex, DNA sequences, custom alphabets).
• pass() — human-readable temporary passwords; enforces complexity minimums automatically.
• base64() — bcrypt salts, URL-safe tokens; uses the bcrypt64 alphabet (. / A-Z a-z 0-9).
• integer() — when you need a number in a range; use cryptoSecure option for security-sensitive values.
• shuffle() — when you need a randomized copy of a string or array without modifying the original.

integer($min, $max, $options)

Return a random integer. Uses random_int() (cryptographically secure) when available.

$n = $rand->integer(1, 100);    // 1–100
$n = $rand->integer();          // 0 to PHP_INT_MAX
$n = $rand->integer(['min' => 1, 'max' => 100]); // options-array form

Force cryptographic security (throws WireException if unavailable):

$n = $rand->integer(0, 100, ['cryptoSecure' => true]);

Get info about which random source was used:

list($value, $type) = $rand->integer(0, 100, ['info' => true]);
// $type is one of: 'random_int', 'mcrypt', 'mt_rand'

cryptoSecure()

Check whether a cryptographically secure random source is available.

if($rand->cryptoSecure()) {
    // random_int() is available; all methods are crypto-secure
}

arrayValue($a)

Get a random value from an array.

$color = $rand->arrayValue(['red', 'green', 'blue']); // e.g. "green"

arrayValues($a, $qty)

Get a randomized copy of an array, or a random subset.

$shuffled = $rand->arrayValues(['a', 'b', 'c', 'd']);   // all 4, shuffled
$subset   = $rand->arrayValues(['a', 'b', 'c', 'd'], 2); // 2 random items

arrayKey($a)

Get a random key from an array.

$key = $rand->arrayKey(['name' => 'John', 'age' => 30]); // "name" or "age"

arrayKeys($a, $qty)

Get randomized keys, or a random subset of keys.

$keys = $rand->arrayKeys(['a' => 1, 'b' => 2, 'c' => 3]);      // all keys, shuffled
$keys = $rand->arrayKeys(['a' => 1, 'b' => 2, 'c' => 3], 2);   // 2 random keys

shuffle($value)

Shuffle a string or array. Unlike PHP's shuffle(), this returns a new copy (does not modify in place), preserves array keys, works with strings, and is cryptographically secure.

$s = $rand->shuffle('Hello');         // e.g. "lloHe"
$a = $rand->shuffle([1, 2, 3, 4]);   // e.g. [2 => 3, 0 => 1, 3 => 4, 1 => 2]

• Source file: wire/core/Tools/WireRandom/WireRandom.php
• Methods prefer cryptographically secure sources when available. integer() and methods that use it rely on random_int() when available. base64() tries byte-oriented secure sources like random_bytes() first.
• shuffle() supports multibyte strings when mb_substr is available.
• base64() uses the bcrypt64 alphabet, not standard base64 — the output is NOT compatible with base64_decode().
• alphanumeric() with strict or require options uses a retry loop until requirements are met.