萬盛學電腦網

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

PHP 生成 GUID/UUID 完整指南:函數與類兩種實現

什麼是 GUID / UUID?

GUID(Globally Unique Identifier,全球唯一標識符),又稱 UUID(Universally Unique Identifier)。它是一個 128 位(16 字節)的二進制數值,通常以 32 位十六進制字符表示,格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx(8-4-4-4-12 分組),例如:6F9619FF-8B86-D011-B42D-00C04FC964FF。

核心優勢

  • 時空唯一性:結合時間戳、機器標識(MAC/IP)、隨機數,理論上全球範圍內不重複。
  • 去中心化生成:無需中央權威機構協調,各節點獨立生成即可保證唯一性。
  • 固定長度、便於存儲:36 字符(含連字符)或 32 字符(純十六進制),適合資料庫主鍵、分佈式 ID、追蹤碼等場景。
  • 跨平台標準:RFC 4122 規範,各語言生態均有成熟實現。

方案一:輕量級函數實現(基於 MD5 + 隨機種子)

適合簡單場景,無依賴,代碼極簡:

<?php
function create_guid(): string {
    // 1. 獲取高熵值隨機字符串:微秒時間 + 高精度隨機數
    $charid = strtoupper(md5(uniqid(mt_rand(), true)));
    $hyphen = '-';
    
    // 2. 按 RFC 4122 格式組裝:8-4-4-4-12
    $uuid = '{'
        . substr($charid, 0, 8) . $hyphen
        . substr($charid, 8, 4) . $hyphen
        . substr($charid, 12, 4) . $hyphen
        . substr($charid, 16, 4) . $hyphen
        . substr($charid, 20, 12)
        . '}';
    
    return $uuid; // 如 {A1B2C3D4-E5F6-7890-ABCD-EF1234567890}
}

// 使用示例
echo create_guid();
?>

注意:此為簡易實現,非嚴格符合 RFC 4122 版本/變體位規範,但滿足大多數業務唯一性需求。

方案二:面向對象完整類實現(模擬 Java 風格)

提供 System、NetAddress、Random、Guid 四個協作類,邏輯更清晰,擴展性更強:

<?php
// guid.class.php

class System {
    public static function currentTimeMillis(): string {
        list($usec, $sec) = explode(" ", microtime());
        return $sec . substr($usec, 2, 3); // 毫秒級時間戳
    }
}

class NetAddress {
    public $Name = 'localhost';
    public $IP = '127.0.0.1';

    public static function getLocalHost(): self {
        $addr = new self();
        $addr->Name = $_ENV['COMPUTERNAME'] ?? 'unknown';
        $addr->IP = $_SERVER['SERVER_ADDR'] ?? '127.0.0.1';
        return $addr;
    }

    public function toString(): string {
        return strtolower($this->Name . '/' . $this->IP);
    }
}

class Random {
    public function nextLong(): string {
        $sign = rand(0, 1) ? '-' : '';
        return $sign 
            . rand(1000, 9999) . rand(1000, 9999) 
            . rand(1000, 9999) . rand(100, 999) . rand(100, 999);
    }
}

class Guid {
    private $valueBeforeMD5;
    private $valueAfterMD5;

    public function __construct() {
        $this->getGuid();
    }

    private function getGuid(): void {
        $address = NetAddress::getLocalHost();
        $this->valueBeforeMD5 = $address->toString() . ':' . System::currentTimeMillis() . ':' . (new Random())->nextLong();
        $this->valueAfterMD5 = md5($this->valueBeforeMD5);
    }

    public static function newGuid(): self {
        return new self();
    }

    public function toString(): string {
        $raw = strtoupper($this->valueAfterMD5);
        return substr($raw, 0, 8) . '-'
             . substr($raw, 8, 4) . '-'
             . substr($raw, 12, 4) . '-'
             . substr($raw, 16, 4) . '-'
             . substr($raw, 20, 12); // 標準格式,不含大括號
    }
}
?>

調用方式

<?php
require_once 'guid.class.php';
$guid = Guid::newGuid();
echo $guid->toString(); // 輸出如:A1B2C3D4-E5F6-7890-ABCD-EF1234567890
?>

現代 PHP 最佳實踐建議

PHP 7+ 環境下,強烈推薦使用成熟庫 ramsey/uuid,完整支援 RFC 4122 所有版本(v1~v8),且經過大規模生產驗證:

composer require ramsey/uuid

use Ramsey\Uuid\Uuid;

$uuid = Uuid::uuid4()->toString(); // 隨機 UUID v4
$uuid = Uuid::uuid1()->toString(); // 基於時間+MAC 的 UUID v1
$uuid = Uuid::uuid7()->toString(); // 新標準:時間有序 UUID v7(適合資料庫主鍵)

總結對比

維度簡易函數自定義類ramsey/uuid
代碼量極少中等零(Composer 引入)
標準合規非嚴格自定義格式完全符合 RFC 4122
性能極快良好優化過,生產級
功能豐富度單一可擴展全版本支援、編碼/解碼、排序優化
推薦場景舊項目、無 Composer 環境教學、特殊格式需求所有現代 PHP 項目

結語

GUID/UUID 是分佈式系統、數據同步、日誌追蹤等場景的基石。理解其生成原理有助於選型,但生產環境請優先採用社區維護的標準庫,避免重複造輪子帶來的隱患。

copyright © 萬盛學電腦網 all rights reserved