PHP 生成 GUID/UUID 完整指南：函數版、類版、RFC 4122 標準合規與效能對比

GUID（Globally Unique Identifier）/ UUID（Universally Unique Identifier）是分散式系統、資料庫主鍵、追蹤 ID 的標準選擇。本文提供兩種實現（函數版、類版），解析 RFC 4122 版本 4（隨機）算法，並給出生產級封裝建議。

一、GUID 格式與版本

xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx
│        │    │    │
│        │    │    └ Variant (bit 6-7): 10xx (RFC 4122)
│        │    └ Version (bit 12-15): 0100 = Version 4 (Random)
│        └ Time Hi
└ Time Low

• Version 4：隨機生成，無需中央協調，碰撞概率極低（~10^-38）。
• Variant：RFC 4122 標準變體（位模式 `10x`）。

二、函數版實現（簡潔、高效）

function generateGuidV4(): string {
    // 16 位元組隨機數據
    $bytes = random_bytes(16);

    // 設定 Version (4) 與 Variant (RFC 4122)
    $bytes[6] = chr(($bytes[6] & 0x0f) | 0x40); // Version 4
    $bytes[8] = chr(($bytes[8] & 0x3f) | 0x80); // Variant 10x

    // 格式化為 8-4-4-4-12
    return vsprintf('%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x', array_values(unpack('C*', $bytes)));
}

// 使用
echo generateGuidV4(); // 例: 6f9619ff-8b86-4011-b42d-00c04fc964ff

三、類版實現（可擴展、支援命名空間）

class Guid {
    private string $value;

    public function __construct(string $guid = '') {
        $this->value = $guid ?: self::generateV4();
    }

    public static function generateV4(): string {
        $bytes = random_bytes(16);
        $bytes[6] = chr(($bytes[6] & 0x0f) | 0x40);
        $bytes[8] = chr(($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)));
    }

    // Version 3/5: 命名空間 + 名稱 (MD5/SHA1)
    public static function generateV3(string $namespace, string $name): string { /* MD5 實現 */ }
    public static function generateV5(string $namespace, string $name): string { /* SHA1 實現 */ }

    public function __toString(): string {
        return $this->value;
    }

    public function getBytes(): string {
        return pack('H*', str_replace('-', '', $this->value));
    }

    public function equals(Guid $other): bool {
        return $this->value === $other->value;
    }
}

// 使用
$guid = new Guid();
echo $guid; // 自動生成 V4
$guid2 = new Guid('6f9619ff-8b86-4011-b42d-00c04fc964ff'); // 解析現有

四、舊版實現分析（文中類版）

原文類版採用「主機名 + 微秒時間 + 隨機數」→ MD5 → 格式化。缺點：

• 依賴 `mt_rand()` 非加密安全隨機源。
• MD5 碰撞風險高於直接使用 128-bit 隨機數。
• 時間組件導致可預測性，不符合 Version 4 純隨機語義。

建議棄用，改用 `random_bytes()` 版本。

五、效能與安全對比

六、生產級建議

1. 首選：random_bytes(16) + 位操作設置 Version/Variant（如上函數版）。
2. 框架整合：Laravel `Str::uuid()`、Symfony `Uuid::uuid4()`、Ramsey UUID 庫（支援 V1-V8、編碼/解碼、資料庫欄位類型）。
3. 資料庫主鍵：MySQL 8.0+ `UUID_TO_BIN()` / `BIN_TO_UUID()` 存儲為 `BINARY(16)`，節省 50% 空間並利於索引。
4. 分散式追蹤：結合 OpenTelemetry Trace ID（W3C Trace Context），採用 Version 4 或 Version 8（自定義）。

七、總結

現代 PHP 生成 GUID/UUID，**請直接使用 `random_bytes(16)` 並設置 Version 4 / Variant RFC 4122 位模式**。避免使用 `mt_rand`、`uniqid`、`md5` 等非加密安全組合。若需命名空間衍生（V3/V5）或完整工具鏈，引入 ramsey/uuid 庫是最省心的選擇。

1. 上一篇文章： PHP 移除字串中空格的四種方法：正則、str_replace、strtr 與自定義函數對比
2. 下一篇文章： PHP 大檔案上傳配置全攻略：Nginx、PHP.ini、錯誤碼對照與安全限制

PHP 相關知識

PHP 圖片合成實戰：將頭、身、腿三圖垂直拼接為完整角色圖

PHP 圖片合成實戰：多圖垂直拼接 在遊戲道具生成、角色裝備

解決PHP無法加載MySQL擴展模塊的根因分析與修復方案

「PHP無法加載MySQL擴展」是開發者高頻遇到的環境問題，

CodeIgniter 4 框架安裝與專案初始化完整教學 (Composer 方式)

CodeIgniter 4 現代化安裝指南：Composer

Linux 下安裝 PHP imagick 擴充套件完整教學（LNMP 環境）

ImageMagick 是強大的圖片處理庫，imagick