您的位置:

PHP uniqid函数用法详解

在PHP的开发中,经常需要为某些变量生成唯一标识符,这时候可以使用PHP内置函数 uniqid()。本文将详细介绍 uniqid() 的用法及其注意事项。

一、uniqid函数简介

PHP中的uniqid() 函数用于生成一个唯一的ID,一般用于为某个变量或者文件命名(主要使用在上传文件、框架开发、缓存系统等场景)。这个id可以是一个更好的数据库主键,或是可以帮助您检查一些错误。

二、uniqid函数的用法

uniqid() 函数的语法如下:

string uniqid ([ string $prefix = "" [, bool $more_entropy = FALSE ]] )
  • prefix 为可选参数,用来指定生成的唯一ID前缀。如果想要前缀可用用microtime()
  • more_entropy 为可选参数,如果设置为 TRUE,将会生成一个加强的唯一ID

下面是一些使用示例:

1. 生成简单的唯一ID

$unique_id = uniqid();
echo $unique_id;

这个代码将会输出类似 5d35ccdfe11e2 的唯一ID。默认情况下,uniqid() 函数不会生成加强的唯一 ID。生成的唯一ID包含两部分:当前时间戳和微秒级别的随机数。两部分中间用 '.' 连接。

2. 在 prefix 参数中设置前缀

$unique_id = uniqid('example');
echo $unique_id;

前缀不同于唯一ID的生成,它只是添加到生成的唯一 ID 前面。这个代码将会输出类似example5d35ccdfe11e2 的带前缀的唯一ID。

3. 使用 microtime() 函数添加额外的 entropy

$unique_id = uniqid('', true);
echo $unique_id;

如果将more_entropy(第二个参数)设置为true,将会添加额外的随机数据。代码将会输出类似 5d35d07eeddbd2.84371161 这样的 ID,其中后面的那个数是经过额外加强的唯一ID。

三、随机数的生成方式

在PHP中,uniqid() 函数以当前时间为种子来生成一段随机数。这个随机数有两种不同的方式生成。

1. 使用 gettimeofday() 函数

在 Linux和Unix 系统下,PHP将使用 gettimeofday() 函数来获取当前时间。这个函数返回一个包含当前时间和微妙数的数组,在这个数组中,第一项是 当前 Unix 时间戳,第二项是 微秒数。

将这些数值格式化为唯一ID:

/**
 * 获取随机数并格式化
 * @return string
 */
function formatUniqId() {
    $timeArr = gettimeofday();
    $id = sprintf('%08x%05x%04x%03x', $timeArr['sec'], ($timeArr['usec'] / 10), getmypid(), \rand(0, 999));
    return $id;
}

2. 使用 Windows API 函数生成随机数

在 Window 系统下,PHP使用 Windows API 函数 GetTickCount() 获取系统时间。这个函数返回从系统启动开始计算的微秒数,但是每 49.7 天会发生一次回绕(overflow),并且会直接影响你的唯一 ID 的生成方式。有人甚至会借此来计算 Windows 工作时间。

下面是一个Windows平台下使用的唯一ID生成代码:

/**
 * 获取随机数并格式化
 * @return string
 */
function formatUniqId() {
    static $incr = 0;
    $time = explode(' ', microtime());
    $id = substr($time[1], 2) . str_pad(substr($time[0], 2, 6) . (++$incr % 1000000), 6, '0', STR_PAD_LEFT);
    return $id;
}

四、注意事项

尽管 uniqid() 函数可以为我们生成唯一ID,但是我们也需要注意到一些问题:

  • uniqid() 仅仅只是生成唯一 ID 的工具,我们还需要根据自己的业务场景来决定是否需要更多完善的处理
  • 在一种情况下,生成的唯一ID会发生重复现象:当多个请求同时调用 uniqid() 函数时,由于其使用时间作为参数,可能会在同一时刻生成相同的ID
  • more_entropy 参数设置为true时,还需要注意多进程并发下的并发问题
  • 由于uniqid() 的唯一性是基于当前时间的,所以必须尽可能的使用NTP同步服务器时间,否则可能会出现时间误差

总结

uniqid() 函数是PHP中用于生成唯一ID的一个内置函数,具有很好的应用价值。在实际开发中,我们需要结合自己的业务场景和需要生成的唯一ID进行相关的优化和改造。同时我们也需要尽可能地避免一些并发和时间同步等问题。