wp_generate_uuid4:WordPress 5.3+ 的标准 UUID 生成函数
wp_generate_uuid4 是 WordPress 5.3 及以上版本引入的核心函数,位于 wp-includes/functions.php,不可被覆盖。该函数用于生成符合 RFC 4122 标准的 UUID v4(通用唯一识别码),基于随机数算法,具备极高的唯一性,广泛适用于数据库主键、API Token、表单防重提交等场景。
函数返回与格式规范
函数返回值为长度 36 的字符串,格式固定为:
8 位 - 4 位 - 4 位 - 4 位 - 12 位(以连字符分隔)。
- 第 13 位字符固定为 "4",标识 UUID 版本为 v4;
- 第 17 位字符固定为 "8"、"9"、"a" 或 "b",表示遵循 RFC 4122 变体标准。
示例输出:550e8400-e29b-41d4-a716-446655440000
使用示例:防止表单重复提交
// 生成 UUID 作为表单提交的唯一标识(防止重复提交)
$form_nonce = wp_generate_uuid4();
// 存储到 session 或数据库,用于后续验证
常见唯一标识生成函数对比
函数 |
特点 |
适用场景 |
wp_generate_uuid4 |
标准 UUID v4,36 字符,极高唯一性 |
API Token、分布式主键 |
wp_generate_password |
可自定义长度和复杂度,用于密码 |
用户密码、临时密码 |
uniqid |
基于时间戳,13-23 字符,碰撞风险较高 |
简单临时标识、文件名 |
wp_rand |
生成随机整数 |
随机数生成、抽奖 |

