(PHP 4, PHP 5, PHP 7, PHP 8)
uniqid — 生成一个唯一ID
获取一个带前缀、基于当前时间微秒数的唯一ID。
本函数并不会生成安全加密的值,并且不可用于加密或者要求返回值不可猜测的目的。
如果需要加密安全随机,则可以将 Random\Engine\Secure 引擎用于 Random\Randomizer。对于简单的用例,random_int() 和 random_bytes() 函数提供了操作系统的 CSPRNG 支持的方便且安全的 API。
此函数不保证返回值的唯一性。由于绝大多数系统使用 NTP
或者类似服务调整系统的时间,所以系统时间经常发生变化。此外,进程/线程可能不会返回唯一的
ID。用 more_entropy
来增加唯一性的概率。
返回字符串形式的唯一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
。