大网数据广告活动
PHP 语言与运行手册

lcg_value · 组合线性同余发生器

· 52CE 我爱测

lcg_value() 返回范围为 (0, 1) 的一个伪随机数。本函数组合了周期为 2^31 - 85 和 2^31 - 249 的两个同余发生器。本函数的周期等于这两个素数的乘积。

lcg_value

(PHP 4, PHP 5, PHP 7, PHP 8)

lcg_value — 组合线性同余发生器

警告

此函数自 PHP 8.4.0 起弃用。强烈建议不要应用此函数。

说明

#[\Deprecated(
    since: '8.4',
    message: "use \\Random\\Randomizer::getFloat() instead",
)]

function lcg_value(): float

lcg_value() 返回范围为 (0, 1) 的一个伪随机数。本函数组合了周期为 2^31 - 85 和 2^31 - 249 的两个同余发生器。本函数的周期等于这两个素数的乘积。

警告

本函数并不会生成安全加密的值,并且不可用于加密或者要求返回值不可猜测的目的。

如果需要加密安全随机,则可以将 Random\Engine\Secure 引擎用于 Random\Randomizer。对于简单的用例,random_int() 和 random_bytes() 函数提供了操作系统的 CSPRNG 支持的方便且安全的 API。

警告

Scaling the return value to a different interval using multiplication or addition (a so-called affine transformation) might result in a bias in the resulting value as floats are not equally dense across the number line. As not all values can be exactly represented by a float, the result of the affine transformation might also result in values outside of the requested interval.

使用 Random\Randomizer::getFloat() 在任意间隔内生成随机浮点数。使用 Random\Randomizer::getInt() 在任意间隔内生成随机整数。

参数

此函数没有参数。

返回值

介于 0.0 和 1.0(含)之间的伪随机浮点值。

更新日志

版本 说明
8.4.0 此函数已被弃用。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。