在開發 API Token、驗證碼、臨時密碼等場景時,常需生成包含數字、大小寫字母的隨機字符串。本文提供一個可配置字符類型、長度的通用函數,並分析其邏輯與潛在改進點。
<?php
/**
* 生成隨機字符串
* @param string $type 字符類型組合,可選 number,upper,lower,用逗號分隔
* @param int $length 字符串長度
* @return string|false 成功返回字符串,參數非法返回 false
*/
function randomString($type = 'number,upper,lower', $length) {
$valid_types = ['number', 'upper', 'lower'];
$requested = explode(',', $type);
// 參數合法性檢查:所有請求類型必須在合法列表中
if (count($requested) !== count(array_intersect($requested, $valid_types))) {
return false;
}
$pool = '';
foreach ($requested as $t) {
switch ($t) {
case 'lower': $pool .= 'abcdefghijklmnopqrstuvwxyz'; break;
case 'upper': $pool .= 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'; break;
case 'number': $pool .= '0123456789'; break;
}
}
// 打亂字符池並截取指定長度
return substr(str_shuffle($pool), 0, $length);
}
// 使用範例
echo randomString('number,upper,lower', 12); // 例:aB3k9Mp2Qx7L
?>
array_intersect 確保傳入類型均為預期值,防止注入任意字符池。str_shuffle() 將字符池隨機排序,再用 substr() 截取所需長度。當 $length 較小(如 4)且字符池較大時,隨機抽樣可能導致某類字符(如數字)完全不出現。若業務強制要求「至少包含一個數字、一個大寫、一個小寫」,可改用「保底填充法」:
function randomStringStrict($type = 'number,upper,lower', $length) {
$maps = [
'number' => '0123456789',
'upper' => 'ABCDEFGHIJKLMNOPQRSTUVWXYZ',
'lower' => 'abcdefghijklmnopqrstuvwxyz',
];
$requested = explode(',', $type);
$pool = '';
$result = '';
// 先從每類強制取一個
foreach ($requested as $t) {
$chars = $maps[$t];
$result .= $chars[random_int(0, strlen($chars)-1)];
$pool .= $chars;
}
// 剩餘長度從完整池隨機補齊
$remaining = $length - count($requested);
if ($remaining > 0) {
$result .= substr(str_shuffle($pool), 0, $remaining);
}
// 最後再打亂一次,打破固定順序
return str_shuffle($result);
}
str_shuffle() 使用 Mersenne Twister,非加密安全。若用於生成 Token、密碼重設鏈接等敏感場景,應改用 random_bytes() 或 random_int() 搭配自定義映射,或直接使用 bin2hex(random_bytes($n)) 生成十六進制字符串。
基礎版 randomString() 結構清晰、易於擴展,適合一般業務場景。對於安全敏感或強制字符類型分佈的需求,建議採用改進版或引入專門庫(如 paragonie/random_compat、ramsey/uuid)。