萬盛學電腦網

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

PHP 產生隨機字串最佳實務:加密級安全與效能優化

前言

隨機字串廣泛用於 API Token、密碼重設碼、Session ID 等安全敏感場景。本文介紹現代 PHP 正確產生隨機字串的方法,避免常見安全漏洞。

❌ 錯誤做法:使用 rand() / mt_rand()

<?php
// ❌ 不安全:可預測、非加密級
function genRandomString_old($len) {
    $chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
    $str = '';
    for ($i = 0; $i < $len; $i++) {
        $str .= $chars[mt_rand(0, strlen($chars) - 1)];
    }
    return $str;
}
?>

風險: `mt_rand()` 種子空間小(32 位元),可被暴力破解預測後續輸出。

✅ 正確做法:random_int() / random_bytes() (PHP 7+)

方法一:random_int() 逐字元選擇

<?php
function genRandomString(int $length = 32, string $charset = 'alphanumeric'): string {
    $charsets = [
        'alphanumeric' => 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789',
        'alpha'        => 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ',
        'numeric'      => '0123456789',
        'hex'          => '0123456789abcdef',
        'base64'       => 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/',
        'safe'         => '23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnpqrstuvwxyz', // 移除易混淆字元
    ];
    
    $chars = $charsets[$charset] ?? $charsets['alphanumeric'];
    $maxIndex = strlen($chars) - 1;
    $result = '';
    
    for ($i = 0; $i < $length; $i++) {
        $result .= $chars[random_int(0, $maxIndex)];
    }
    
    return $result;
}

// 使用範例
echo genRandomString(32);           // 32 字元英數混合
echo genRandomString(16, 'hex');    // 16 字元十六進位
echo genRandomString(24, 'safe');   // 24 字元無易混淆字元
?>

方法二:random_bytes() + Base64/HEX 編碼(效能更好)

<?php
function genRandomBytes(int $bytes = 32, string $encoding = 'base64url'): string {
    $bytes = random_bytes($bytes);
    
    return match ($encoding) {
        'base64'     => base64_encode($bytes),
        'base64url'  => rtrim(strtr(base64_encode($bytes), '+/', '-_'), '='),
        'hex'        => bin2hex($bytes),
        'raw'        => $bytes,
        default      => throw new InvalidArgumentException("不支援的編碼: {$encoding}"),
    };
}

// 使用範例
echo genRandomBytes(32, 'base64url'); // 43 字元 URL 安全 Base64
echo genRandomBytes(16, 'hex');       // 32 字元十六進位
?>

效能比較

方法32 字元耗時 (μs)安全性適用場景
`mt_rand()` 迴圈~15❌ 低非安全場景(測試資料)
`random_int()` 迴圈~45✅ 高自定字元集需求
`random_bytes()` + bin2hex~8✅ 高Token、API Key、Session ID
`random_bytes()` + base64url~10✅ 高JWT、URL 安全 Token

實務應用場景

1. API Token / Access Token

<?php
function generateApiToken(): string {
    // 32 bytes = 256 bits entropy,Base64URL 編碼 = 43 字元
    return genRandomBytes(32, 'base64url');
}

// 資料庫存儲建議:UNIQUE INDEX + 前綴識別
// INSERT INTO api_tokens (token_hash, user_id, expires_at) VALUES (SHA2(?, 256), ?, ?)
?>

2. 密碼重設 Token

<?php
function generateResetToken(): array {
    $token = genRandomBytes(32, 'base64url');
    $hash = hash('sha256', $token); // 資料庫只存雜湊
    $expires = (new DateTime())->modify('+1 hour')->format('Y-m-d H:i:s');
    
    return [
        'token' => $token,      // 寄給使用者(唯一顯示一次)
        'hash' => $hash,        // 存資料庫
        'expires_at' => $expires,
    ];
}
?>

3. CSRF Token

<?php
function generateCsrfToken(): string {
    // 16 bytes 足夠,Session 存儲
    return genRandomBytes(16, 'base64url');
}

// 驗證
function validateCsrfToken(string $input, string $sessionToken): bool {
    return hash_equals($sessionToken, $input); // 時序安全比較
}
?>

PHP 5.x 相容方案(若必須維護舊版)

<?php
// PHP 5.x 使用 openssl_random_pseudo_bytes()
function genRandomString_legacy(int $length = 32): string {
    $bytes = openssl_random_pseudo_bytes($length, $strong);
    if (!$strong) {
        throw new RuntimeException('無法產生加密級隨機數');
    }
    return rtrim(strtr(base64_encode($bytes), '+/', '-_'), '=');
}
?>

安全性檢核清單

  • ✅ 使用 `random_int()` / `random_bytes()` / `openssl_random_pseudo_bytes()`
  • ✅ 熵值足夠:Token 至少 128 bits(16 bytes),建議 256 bits(32 bytes)
  • ✅ 字元集適合用途(URL 安全、無易混淆字元)
  • ✅ 資料庫儲存**雜湊值**(SHA-256 或 bcrypt),不存明文
  • ✅ 設定過期時間與撤銷機制
  • ✅ 使用 `hash_equals()` 進行時序安全比較
copyright © 萬盛學電腦網 all rights reserved