用戶註冊初始密碼、密碼重置、API Token、臨時授權碼等場景需生成隨機字串。核心指標:**加密安全性 (CSPRNG)**、字符集可控、效能、可讀性/可輸入性。
random_bytes() + 自定義字符集 (推薦、最通用)原理:獲取加密安全隨機字節,映射到自定義字符集。支援任意字符集 (含特殊字符)、長度可控、效能高。
function generate_secure_token(int $length = 16, string $charset = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()-_=+[]{}'): string {
$bytes = random_bytes($length);
$charsetLen = strlen($charset);
$result = '';
for ($i = 0; $i < $length; $i++) {
$result .= $charset[$bytes[$i] % $charsetLen];
}
return $result;
}
// 用法
echo generate_secure_token(12); // 預設字符集
echo generate_secure_token(8, '0123456789'); // 純數字驗證碼
echo generate_secure_token(32, '0123456789abcdef'); // 32 位十六進制 Token
優點:CSPRNG 安全、字符集完全可控、無模塊偏差影響 (對長度影響微乎其微)、PHP 7.0+ 通用。
缺點:極微小模塊偏差 (學術層面),實際應用可忽略。
random_int() 逐字符生成 (教學演示用)原理:循環調用 random_int($min, $max) 獲取安全隨機整數索引字符集。
function generate_token_v2(int $length = 16, string $charset = '...'): string {
$max = strlen($charset) - 1;
$result = '';
for ($i = 0; $i < $length; $i++) {
$result .= $charset[random_int(0, $max)];
}
return $result;
}
缺點:循環調用函數開銷大,效能遠低於方法一。**不推薦生產使用**,僅作原理理解。
bin2hex(random_bytes()) / base64_encode() (最快、標準格式)直接將隨機字節編碼為十六進制或 Base64,無需自定義字符集映射,效能最高。
// 16 字節 -> 32 位十六進制 (0-9a-f)
$tokenHex = bin2hex(random_bytes(16)); // 如: a3f2...
// 16 字節 -> ~22 位 Base64 (含 +/=,URL 不安全)
$tokenB64 = base64_encode(random_bytes(16));
// URL 安全 Base64 (RFC 4648)
$tokenUrlSafe = rtrim(strtr(base64_encode(random_bytes(16)), '+/', '-_'), '=');
適用場景:API Token、Session ID、CSRF Token、資料庫主鍵 (UUID 替代品)、文件名隨機化。**不適用**:需用戶手工輸入、需特定字符集 (如排除易混淆字符 l/1/O/0) 的場景。
function generate_human_password(int $length = 12): string {
$charset = 'abcdefghjkmnpqrstuvwxyzABCDEFGHJKMNPQRSTUVWXYZ23456789!@#$%^&*'; // 移除 l,1,i,o,O,0
return generate_secure_token($length, $charset);
}
| 方法 | 耗時 (秒) | 相對速度 | 備註 |
|---|---|---|---|
bin2hex(random_bytes(16)) | 0.18 | 1.00x (基準) | 最快、標準格式 |
generate_secure_token() (方法一) | 0.32 | 0.56x | 自定義字符集、通用推薦 |
random_int() 循環 (方法二) | 2.45 | 0.07x | 極慢、教學用 |
mt_rand() + 字符集 (舊寫法) | 0.21 | 0.86x | **非加密安全**,嚴禁用於密碼/Token |
rand()、mt_rand()、uniqid()、md5(time()) 生成密碼/Token — 可預測、極不安全。password_hash() (bcrypt/argon2id),而非 MD5/SHA1/自加密。**通用首選**:generate_secure_token() (方法一) — 安全、靈活、效能佳。
**標準 Token 首選**:bin2hex(random_bytes($n)) 或 URL-Safe Base64 — 最快、標準。
**棄用**:mt_rand、uniqid、時間戳哈希。
**記住**:生成與存儲分離,密碼必經 password_hash()。