array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.uniqid.php', 1 => 'uniqid', 2 => '生成基于时间的标识符', ), 'up' => array ( 0 => 'ref.misc.php', 1 => '杂项 函数', ), 'prev' => array ( 0 => 'function.time-sleep-until.php', 1 => 'time_sleep_until', ), 'next' => array ( 0 => 'function.unpack.php', 1 => 'unpack', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/misc/functions/uniqid.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

uniqid

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

uniqid — 生成基于时间的标识符

说明

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

获取基于当前时间的标识符，精度为微秒，以指定 prefix 作为前缀，并可选择附加随机生成的值。

警告

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

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

警告

该函数不保证返回值的唯一性，因为该值基于当前时间（以微秒为单位）或当前时间加上少量随机数据（如果 more_entropy 为 true）。

参数

prefix

有用的参数。例如同一微秒时在多台主机上同时生成标识符。（如果系统时钟向后移动，例如通过 NTP 调整，即使在单个主机上也会发生这种情况。）

prefix为空，则返回的字符串长度为 13。more_entropy 为 true，则返回的字符串长度为 23。

more_entropy

如果设置为 true，uniqid() 会在返回的字符串结尾增加额外的熵（使用线性同余组合发生器）。 使得唯一ID更具唯一性。

返回值

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

警告

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

示例

示例 #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。

参见