必须用 random_bytes() 生成密码学安全随机字符串,禁用 rand()、mt_rand()、uniqid() 等非安全函数;推荐 bin2hex() 或 URL 安全 Base64 编码;字符集受限时应采用拒绝采样法映射。

用 random_bytes() 生成安全随机字符串
PHP 7.0+ 必须用 random_bytes(),别碰 rand() 或 mt_rand() —— 它们不是密码学安全的,令牌被预测就等于门没锁。
它返回二进制字节,得转成可读字符串,常见做法是 Base64 或十六进制编码:
$token = bin2hex(random_bytes(32)); // 64 字符十六进制串 $token = rtrim(strtr(base64_encode(random_bytes(32)), '+/', '-_'), '='); // URL 安全 Base64
注意:bin2hex() 输出全是小写字母+数字,长度固定(每字节变 2 字符);base64_encode() 后需替换 +// 并去掉填充 =,否则在 URL 或 JSON 里可能出问题。
为什么不用 uniqid() + md5() 组合
这种写法网上还不少,但本质不安全: uniqid() 基于微秒时间戳,可被推测;加 md5(microtime() . mt_rand()) 也救不回来 —— mt_rand() 的状态能被爆破,整个链路就塌了。
立即学习“PHP免费学习笔记(深入)”;
真实场景中,这类“伪随机”令牌在登录态、CSRF、API key 等环节一旦被撞出,攻击者就能冒充用户。
明确避开以下写法:
uniqid('', true)md5(uniqid(mt_rand(), true))sha1(time() . rand())
字符集受限时怎么安全截取
有些老系统要求令牌只能含字母+数字(比如数据库字段限制为 VARCHAR(32) 且只接受 [a-zA-Z0-9]),不能直接用 bin2hex()(它带 a–f)或 Base64(含 -_)。
这时别手写循环拼接字符数组,容易引入偏差(某些字符概率偏高)。正确做法是:先生成足够长的安全字节,再映射到目标字符集,丢弃越界值(拒绝采样):
$chars = 'ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz23456789';
$bytes = random_bytes(64);
$token = '';
for ($i = 0; $i < 64 && strlen($token) < 32; $i++) {
$idx = ord($bytes[$i]) % strlen($chars);
$token .= $chars[$idx];
}
更稳妥的做法是用 random_int(0, strlen($chars)-1) 替代模运算,避免轻微分布倾斜 —— 尤其当字符集长度不是 2 的幂时。
生成后记得校验长度和字符范围
开发时容易忽略输出是否真符合下游要求。比如你写了 bin2hex(random_bytes(16)),以为得到 32 位字符串,但如果后续逻辑把它当 base64 解码,就会报 Warning: base64_decode(): Invalid character。
上线前建议加一层断言或日志检查:
if (strlen($token) !== 32 || !ctype_alnum($token)) {
throw new RuntimeException('Token format invalid');
}
特别是对接第三方 SDK 或遗留协议时,一个隐藏的字符集错位,可能让整个认证流程静默失败,排查起来极费时间。
真正麻烦的从来不是生成动作本身,而是生成结果在传输、存储、解析各环节是否始终可控 —— 字符编码、截断、大小写转换、空格吞掉,这些细节比函数选哪个更常出问题。



















