萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

深入解析 Discuz! X1.5 随机数生成函数 random 的实现与用法

前言

在 PHP 开发中,生成随机字符串是常见需求。Discuz! X1.5(简称 DZX1.5)内置了一个名为 random 的工具函数,能够根据指定长度和字符集类型(纯数字或纯字母)生成随机字符串。本文将深入剖析该函数的源码实现,并演示其使用方法。

函数签名与参数说明

function random($length, $numeric = 0) {
    // $length: 生成随机字符串的长度(整数)
    // $numeric: 0 或非 0
    //   - 0 表示生成的字符串由字母(大小写)组成
    //   - 非 0 表示生成的字符串仅由数字组成
    // 返回值: 生成的随机字符串
}

核心实现逻辑

  1. 种子生成:利用 microtime() 与 $_SERVER['DOCUMENT_ROOT'] 拼接后进行 MD5 哈希,再通过 base_convert 转换为 35 进制(字母模式)或 10 进制(数字模式),得到一个包含足够熵的种子字符串。
  2. 字符池构建:
    • 数字模式:移除种子中的 '0',并追加 '012340567890' 确保数字分布均匀。
    • 字母模式:在种子后追加 'zZ' 及其大写形式,扩充字母池。
  3. 随机抽取:使用 mt_rand 在字符池中随机选取字符,拼接成指定长度的结果字符串。

完整源码

<?php
function random($length, $numeric = 0) {
    $seed = base_convert(md5(microtime().$_SERVER['DOCUMENT_ROOT']), 16, $numeric ? 10 : 35);
    $seed = $numeric ? (str_replace('0', '', $seed).'012340567890') : ($seed.'zZ'.strtoupper($seed));
    $hash = '';
    $max = strlen($seed) - 1;
    for($i = 0; $i < $length; $i++) {
        $hash .= $seed{mt_rand(0, $max)};
    }
    return $hash;
}

// 示例调用
echo random(15, 1); // 生成 15 位纯数字随机串
echo '<br />';
echo random(15);    // 生成 15 位纯字母随机串

运行结果示例

228283270677112

SjqffsU76994qfS

适用场景与注意事项

  • 适用于生成验证码、临时密码、唯一标识等非加密安全场景。
  • 由于依赖 mt_rand(非加密安全随机数生成器),不建议用于生成加密密钥、会话 Token 等安全敏感数据。
  • 若项目已升级至 PHP 7+,推荐使用 random_int 或 random_bytes 替代。
copyright © 萬盛學電腦網 all rights reserved