Random\Randomizer 是 PHP 8.2+ 安全随机数的推荐 OO 封装，默认使用 Random\Engine\Secure（操作系统 CSPRNG），提供可复用、隔离状态、支持自定义引擎的灵活接口，但不替代 random_int()/random_bytes() 的轻量直接性。
Random\Randomizer 是 PHP 8.2+ 安全随机数的推荐入口
PHP 8.2 引入的 Random\Randomizer 类不是替代 random_int() 或 random_bytes() 的“新标准”，而是提供面向对象、可定制、多独立序列能力的封装层。它默认使用 Random\Engine\Secure（即操作系统 CSPRNG），因此生成结果天然加密安全——只要你不显式换用 Random\Engine\PcgOneseq128XslRr64 这类非安全引擎。
关键点在于：它不改变底层安全性，但改变了调用方式和扩展性。你仍需理解何时该用整数、何时该用字节，Random\Randomizer 只负责把这件事做得更灵活。
- 构造时无参数 → 默认启用
Random\Engine\Secure，无需额外配置 - 若传入
new Random\Engine\Secure()，行为与默认一致，显式写法仅用于强调或未来兼容 - 不要传入
Random\Engine\PcgOneseq128XslRr64或Random\Engine\Mt19937—— 它们是伪随机引擎，不适用于 token、密钥等场景 - 同一个
Random\Randomizer实例可复用，内部状态隔离，不会污染全局 RNG
生成 [min, max] 区间安全整数：用 randomInt() 而非 rand() 风格写法
Random\Randomizer::randomInt() 是 random_int() 的 OO 封装，语义相同、安全性相同，但支持实例化后多次调用，且可搭配自定义引擎（虽然通常不需要）。
错误做法是沿用旧习惯：比如在循环里反复 new Random\Randomizer()，或试图用 randomFloat() + 类型转换模拟整数范围——这既没收益又可能引入偏差。
立即学习“PHP免费学习笔记（深入）”；
- 正确调用：
$r = new Random\Randomizer(); $num = $r->randomInt(1, 100); - 范围必须是整数，且
$min ，否则抛 <code>ValueError - 它仍会抛
Random\RandomException（如系统 CSPRNG 不可用），所以生产环境仍需try/catch - 不要用
randomFloat(0, 1) * 100再(int)转换——浮点舍入 + 截断会导致边界值概率失真
生成随机字符串：别直接 echo randomBytes()，先编码
Random\Randomizer 本身不提供字符串生成方法，但它有 getBytes()，返回的是原始字节流（和 random_bytes() 一样）。这意味着你依然要自己做编码转换，否则可能遇到乱码、截断或 SQL 插入失败。
常见错误是把 $r->getBytes(16) 当作普通字符串直接存数据库或输出，而它可能含 \x00、\x08 等控制字符。
- 转十六进制（推荐用于 token、session id）：
bin2hex($r->getBytes(16))→ 32 字符小写字符串 - 转 URL 安全 Base64（适合密码重置链接）：
rtrim(str_replace(['+', '/', '='], ['-', '_', ''], base64_encode($r->getBytes(18))), '_') - 不要用
implode('', array_map(fn($b) => chr($b % 62), str_split($r->getBytes(12))))这类取模拼接——有统计偏差，且chr()对高位字节会出错 - 若需纯字母数字自定义集，应配合
random_int()循环重试（见 RFC 8438 推荐做法），而非依赖字节取模
为什么不用 Random\Randomizer 也能满足大部分需求？
因为 random_int() 和 random_bytes() 仍是 PHP 8.2+ 最轻量、最直接、最被广泛测试的安全原语。它们没有对象创建开销，不依赖命名空间自动加载，异常类型清晰，文档覆盖全面。
Random\Randomizer 的真实价值出现在需要以下场景时：多个逻辑独立的随机流（如同时生成用户 token 和日志 trace_id）、测试中需要可控种子（用 Random\Engine\Mt19937）、或未来迁移到新算法引擎。对绝大多数 Web 应用来说，它只是多了一层封装，没解决新问题。
最容易被忽略的一点：你在 Docker 容器里跑 PHP 8.2+，如果镜像精简到删了 /dev/urandom 或禁用了 getrandom(2) 系统调用，Random\Randomizer 和 random_int() 会同时失败——这时补丁不在代码层，而在容器配置或内核参数。
