uniqid

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

uniqid生成基于时间的标识符

描述

uniqid(string $prefix = "", bool $more_entropy = false): string

获取基于当前时间(具有微秒精度)的标识符,该标识符以给定的 prefix 为前缀,并可选地附加随机生成的值。

注意

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

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

警告

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

参数

prefix

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

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

more_entropy

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

返回值

返回基于时间戳的标识符作为字符串。

警告

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

示例

示例 #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 则注释

ken at smallboxsoftware
17 年前
只是要注意这个函数相当慢,如果它在循环中,可能会使你的脚本速度变得很慢。奇怪的是,如果你运行它为 uniqid('', true),它会运行得快得多。
To Top