PHP Conference Japan 2024

uniqid

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

uniqid生成基于时间的标识符

描述

uniqid(字符串 $prefix = "", 布尔值 $more_entropy = false): 字符串

获取基于当前时间(精确到微秒)的标识符,并在前面加上给定的 prefix 前缀,并可选地附加一个随机生成的值。

注意

此函数不会生成密码学安全的随机值,并且绝不能用于加密目的,或需要返回值不可猜测的目的。

如果需要密码学安全的随机性,则可以使用 Random\RandomizerRandom\Engine\Secure 引擎。对于简单用例,random_int()random_bytes() 函数提供了一个方便且安全的 API,它由操作系统的 CSPRNG 支持。

警告

此函数不保证返回值的唯一性,因为该值基于当前时间的微秒数,或者如果 more_entropytrue,则附加少量随机数据。

参数

prefix

例如,如果您在可能在同一微秒生成相同标识符的多个主机上同时生成标识符,则此功能很有用。(如果系统时钟向后移动,例如通过 NTP 调整,则即使在单个主机上也可能发生这种情况。)

使用空 prefix,返回的字符串将为 13 个字符长。如果 more_entropytrue,则它将为 23 个字符。

more_entropy

如果设置为 true,则 uniqid() 将在返回值的末尾添加额外的熵(使用组合线性同余生成器),这增加了结果唯一的可能性。

返回值

以字符串形式返回基于时间戳的标识符。

警告

此函数不保证返回值的唯一性。

示例

示例 #1 uniqid() 示例

<?php
/* 一个 uniqid,例如:4b3403665fea6 */
printf("uniqid(): %s\r\n", uniqid());

/* 我们还可以为 uniqid 添加前缀,这与以下操作相同:
*
* $uniqid = $prefix . uniqid();
* $uniqid = uniqid($prefix);
*/
printf("uniqid('php_'): %s\r\n", uniqid('php_'));

/* 我们还可以激活 more_entropy 参数,这在某些系统(如 Cygwin)上是必需的。这使得 uniqid()
* 生成一个类似的值:4b340550242239.64159797
*/
printf("uniqid('', true): %s\r\n", uniqid('', true));
?>

注释

注意:

在 Cygwin 下,必须将 more_entropy 设置为 true,此函数才能正常工作。

参见

添加注释

用户贡献的注释 1 个注释

2
ken at smallboxsoftware
17 年前
需要说明的是,此函数相当慢,如果在循环中使用,可能会导致脚本运行缓慢。奇怪的是,如果您将其作为 uniqid('', true) 运行,它的运行速度会快得多。
To Top