哈希空间 Ctrl + F 进行搜索
首页 php手册中文版 CSS中文手册 哈希文档 Markdown在线工具

uniqid

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

uniqid生成一个唯一ID

说明

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

获取一个带前缀、基于当前时间微秒数的唯一ID。

警告

本函数并不会生成安全加密的值,不应用于加密用途。若需要安全加密的值,考虑使用 random_int()random_bytes()openssl_random_pseudo_bytes() 替代。

警告

此函数不保证返回值的唯一性。由于绝大多数系统使用 NTP 或者类似服务调整系统的时间,所以系统时间经常发生变化。此外,进程/线程可能不会返回唯一的 ID。用 more_entropy 来增加唯一性的概率。

参数

prefix

有用的参数。例如:如果在多台主机上可能在同一微秒生成唯一ID。

prefix为空,则返回的字符串长度为 13。more_entropytrue,则返回的字符串长度为 23。

more_entropy

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

返回值

返回字符串形式的唯一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

打开 哈希空间 微信小程序中查看更佳