隨機字串廣泛用於 API Token、密碼重設碼、Session ID 等安全敏感場景。本文介紹現代 PHP 正確產生隨機字串的方法,避免常見安全漏洞。
<?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 位元),可被暴力破解預測後續輸出。
<?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 字元無易混淆字元
?>
<?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 |
<?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), ?, ?)
?>
<?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,
];
}
?>
<?php
function generateCsrfToken(): string {
// 16 bytes 足夠,Session 存儲
return genRandomBytes(16, 'base64url');
}
// 驗證
function validateCsrfToken(string $input, string $sessionToken): bool {
return hash_equals($sessionToken, $input); // 時序安全比較
}
?>
<?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), '+/', '-_'), '=');
}
?>