uniqid

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

    uniqid — 生成一个唯一ID

    说明

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

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

    警告

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

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

    警告

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

    参数

    prefix

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

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

    more_entropy

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

    返回值

    返回字符串形式的唯一ID。

    警告

    此函数努力创建唯一识别符，但它不保证返回值得唯一性。

    示例

    示例 #1 uniqid() 例子

    <?php

    printf("uniqid(): %s\r\n", uniqid());


    printf("uniqid('php_'): %s\r\n", uniqid('php_'));


    printf("uniqid('', true): %s\r\n", uniqid('', true));
    ?>

    注释

    注意:

    在 Cygwin 环境下，为了使此函数能够工作，more_entropy 必须设置为 true。

    参见

    To Top