萬盛學電腦網

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

PHP 產生指定長度隨機字串的多種實作與效能比較

需求分析

常見場景:API Token、驗證碼、臨時密碼、檔名鹽值等。需求通常包含:指定長度、字元集可控(大小寫字母、數字、特殊符號)、加密安全性(是否需 CSPRNG)。

方案一:基礎陣列隨機(原文做法)

<?php
function getRandLetter(int $length = 8): string
{
    if ($length <= 0) return '';
    $chars = array_merge(range('A', 'Z'), range('a', 'z')); // 52 個字元
    $result = '';
    for ($i = 0; $i < $length; $i++) {
        $result .= $chars[random_int(0, 51)]; // PHP 7+ 建議用 random_int
    }
    return $result;
}
echo getRandLetter(8); // 例:kQmZpLxR
?>

缺點:迴圈字串連接效能較差;rand() 非加密安全;字元集固定難擴充。

方案二:str_shuffle + substr(簡潔但非安全)

<?php
function randomString(int $length = 8, string $chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'): string
{
    $chars = str_shuffle($chars);
    return substr($chars, 0, $length);
}
// 注意:str_shuffle 使用 Mersenne Twister,非加密安全
?>

方案三:random_bytes + Base64/HEX 編碼(加密安全、效能最佳)

<?php
/**
 * 產生加密安全的隨機字串
 * @param int $length 輸出字串長度
 * @param string $encoding 'base64' | 'hex' | 'base64url'
 * @return string
 */
function secureRandomString(int $length = 32, string $encoding = 'base64url'): string
{
    // 計算所需位元組數
    $bytes = match ($encoding) {
        'base64'    => (int)ceil($length * 3 / 4),
        'base64url' => (int)ceil($length * 3 / 4),
        'hex'       => (int)ceil($length / 2),
        default     => $length,
    };
    
    $random = random_bytes($bytes);
    
    return match ($encoding) {
        'base64'    => rtrim(base64_encode($random), '='),
        'base64url' => rtrim(strtr(base64_encode($random), '+/', '-_'), '='),
        'hex'       => bin2hex($random),
        default     => bin2hex($random),
    };
}

// 使用範例
echo secureRandomString(24);      // 24 字元 URL-safe Base64,適合 Token
echo secureRandomString(32, 'hex'); // 32 字元 HEX,適合 API Key
?>

方案四:自訂字元集 + CSPRNG(兼顧安全與字元集控制)

<?php
/**
 * 使用加密安全隨機數從自訂字元集選取
 */
function customRandomString(int $length, string $charset = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'): string
{
    if ($length <= 0) return '';
    $charsetLen = strlen($charset);
    $maxByte = 256 - (256 % $charsetLen); // 避免模數偏差
    $result = '';
    
    while (strlen($result) < $length) {
        $bytes = random_bytes($length - strlen($result));
        for ($i = 0; $i < strlen($bytes); $i++) {
            $byte = ord($bytes[$i]);
            if ($byte < $maxByte) {
                $result .= $charset[$byte % $charsetLen];
                if (strlen($result) >= $length) break;
            }
        }
    }
    return $result;
}

// 使用範例
echo customRandomString(10, 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789'); // 移除易混淆字元,適合人工輸入驗證碼
?>

效能與安全性比較表

方案加密安全效能字元集靈活度適用場景
陣列 + random_int是中(迴圈開銷)高短字串、教學示範
str_shuffle否高中非安全場景、快速原型
random_bytes + Base64/HEX是最高(C 語言層級)低(固定字元集)Token、API Key、Session ID、加密鹽
自訂字元集 + CSPRNG是中高最高驗證碼、邀請碼、人工輸入場景

最佳實踐建議

  1. 安全敏感場景(Token、Key、Session、重設密碼連結):必須使用 random_bytes 或 random_int,嚴禁使用 rand()、mt_rand()、uniqid()、time()。
  2. 長度建議:Token ≥ 32 字元(Base64url 24 字元即對應 180+ bits 熵值)。
  3. 避免模數偏差:方案四展示的 $maxByte 技巧確保字元分布均勻。
  4. 字元集選擇:人工輸入場景移除 0/O, 1/I/l, 8/B 等易混淆字元。

結語

PHP 7+ 提供 random_bytes、random_int 等 CSPRNG 函數,配合 Base64/HEX 編碼或自訂字元集採樣,能以最少代碼實現高效能、高安全性的隨機字串產生。根據業務場景選擇適合方案,並統一封裝為工具類/函數,是專案長期維護的關鍵。

copyright © 萬盛學電腦網 all rights reserved