常見場景: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
?>
<?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 | 是 | 中高 | 最高 | 驗證碼、邀請碼、人工輸入場景 |
random_bytes 或 random_int,嚴禁使用 rand()、mt_rand()、uniqid()、time()。$maxByte 技巧確保字元分布均勻。0/O, 1/I/l, 8/B 等易混淆字元。PHP 7+ 提供 random_bytes、random_int 等 CSPRNG 函數,配合 Base64/HEX 編碼或自訂字元集採樣,能以最少代碼實現高效能、高安全性的隨機字串產生。根據業務場景選擇適合方案,並統一封裝為工具類/函數,是專案長期維護的關鍵。