萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 生成 UUID (GUID) 自定义函数:跨平台兼容、版本 4 随机、符合 RFC 4122

UUID 简介

  • 全称:Universally Unique Identifier
  • 版本:v1 时间+MAC、v3/v5 命名空间+MD5/SHA1、v4 全随机、v2 DCE 安全
  • 格式:8-4-4-4-12 十六进制,共 36 字符,如 550e8400-e29b-41d4-a716-446655440000
  • 用途:分布式 ID、数据库主键、会话标识、追踪 ID

PHP 原生缺口与跨平台方案

Windows PHP 有 com_create_guid(),Linux 无。为统一接口,自定义同名函数落地 v4 随机算法。

标准实现代码

<?php
if (!function_exists('com_create_guid')) {
    /**
     * 生成 RFC 4122 版本 4 (随机) UUID
     * @return string 格式: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
     */
    function com_create_guid(): string {
        // PHP 7+ 使用 random_bytes 保证密码学安全随机
        $bytes = random_bytes(16);

        // 设置版本位 (bit 4-7 of byte 6 = 0100)
        $bytes[6] = ($bytes[6] & 0x0F) | 0x40;
        // 设置变体位 (bit 6-7 of byte 8 = 10)
        $bytes[8] = ($bytes[8] & 0x3F) | 0x80;

        // 格式化为标准字符串
        return vsprintf('%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x', array_values(unpack('C*', $bytes)));
    }
}

// 兼容旧版本 mt_rand 实现(不推荐生产用)
if (!function_exists('com_create_guid')) {
    function com_create_guid(): string {
        return sprintf(
            '%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
            mt_rand(0, 0xffff), mt_rand(0, 0xffff),
            mt_rand(0, 0xffff),
            mt_rand(0, 0x0fff) | 0x4000, // version 4
            mt_rand(0, 0x3fff) | 0x8000, // variant 10
            mt_rand(0, 0xffff), mt_rand(0, 0xffff), mt_rand(0, 0xffff)
        );
    }
}

使用示例

<?php
// 直接调用
$id = com_create_guid();
echo $id; // 如: a3f2b1c0-5d4e-4f3a-8b2c-1d2e3f4a5b6c

// 批量生成
$uuids = array_map(fn() => com_create_guid(), range(1, 5));
print_r($uuids);

进阶:Ramsey/UUID 库(企业级推荐)

composer require ramsey/uuid

use Ramsey\Uuid\Uuid;
use Ramsey\Uuid\Exception\UnsatisfiedDependencyException;

try {
    $uuid = Uuid::uuid4(); // v4 随机
    echo $uuid->toString(); // 标准格式
    echo $uuid->getBytes(); // 16 字节二进制
    echo $uuid->getHex();   // 无连字符十六进制
} catch (UnsatisfiedDependencyException $e) {
    // 回退到内置实现
    echo com_create_guid();
}

性能对比(百万次生成)

数据库存储建议

  • MySQL: CHAR(36) CHARSET ascii 或 BINARY(16) 存二进制(节省空间、索引更快)
  • PostgreSQL: 原生 UUID 类型
  • 二进制存储转换:UUID_TO_BIN() / BIN_TO_UUID() (MySQL 8.0+)

版本选择指南

  • 通用业务主键、追踪 ID → v4 随机(本文实现)
  • 需按时间排序、可溯源 → v1 时间有序 或 ULID
  • 基于命名空间确定性生成 → v5 SHA1

将 com_create_guid() 放入项目公共函数库,即可在全平台统一生成标准 UUID。

copyright © 萬盛學電腦網 all rights reserved
实现耗时(秒)每秒生成安全性
random_bytes + vsprintf~0.81.25MCSPRNG ✅
mt_rand + sprintf~0.33.3M伪随机 ❌
Ramsey\Uuid (默认)~1.20.8MCSPRNG ✅
PECL uuid 扩展~0.25M系统级 CSPRNG ✅