结论：邀请码功能在ThinkPHP中不建议纯靠随机生成，尤其需可逆、不存库、防碰撞、带业务语义时，必须用ID映射+进制转换+混淆组合方案。
直接说结论：邀请码功能在 ThinkPHP 中不建议纯靠随机生成，尤其当需要「可逆、不存库、防碰撞、带业务语义」时，必须用 ID 映射+进制转换+混淆的组合方案。
ThinkPHP 中 mt_rand() 生成邀请码为什么容易出问题
很多人第一反应是用 mt_rand() 拼字符串，比如 str_shuffle('ABCDEFG123') 截 6 位。这在小流量场景下看似能跑通，但实际会踩三个坑：
- 数据库唯一索引冲突频发——6 位纯数字+字母（去重后约 50 个字符），理论最多 50⁶ ≈ 150 亿种组合，但实际用户 ID 是连续递增的，
mt_rand()无法保证「同一 ID 每次生成相同码」，导致重复插入失败 - 无法反查用户来源——前端传回
ABC123，你得知道这是谁发的，但随机码和用户 ID 之间没数学关系，只能查库；而查库又要求你先存一遍，违背「轻量级邀请链路」初衷 - 测试和灰度难控制——比如想给 ID=1001 的用户固定生成
X9F2KQ用于 AB 测试，随机方案做不到稳定复现
基于用户 ID 的可逆邀请码生成（ThinkPHP 6/8 均适用）
核心思路是：把用户 ID 当作一个「十进制数」，转成自定义字符集的「N 进制字符串」，再加一层位置混淆防止被枚举。ThinkPHP 控制器里可以直接封装静态方法：
class InviteCode
{
private static array $CHARS = ['Y','2','U','K','X','V','C','F','N','S','6','8','G','Z','Q','7','A','9','P','H','5','M','R','L','D','J','4','T','W','E','3','B'];
private const BASE = 32;
<pre class="brush:php;toolbar:false;">public static function encode(int $uid, int $len = 6): string
{
if ($uid <= 0) return '';
$n = $uid;
$buf = [];
// 转 base32
while ($n > 0) {
$buf[] = $n % self::BASE;
$n = (int)($n / self::BASE);
}
// 补足长度，高位补 0 对应 $CHARS[0]（即 'Y'）
while (count($buf) < $len) {
array_unshift($buf, 0);
}
// 简单位置置换：i → (i * 3 + 1) % len，避免顺序暴露
$shuffled = array_fill(0, $len, '');
for ($i = 0; $i < $len; $i++) {
$pos = ($i * 3 + 1) % $len;
$shuffled[$pos] = self::$CHARS[$buf[$i]];
}
return implode('', $shuffled);
}
public static function decode(string $code): ?int
{
$len = strlen($code);
if ($len !== 6) return null;
$buf = [];
for ($i = 0; $i < $len; $i++) {
$idx = array_search($code[$i], self::$CHARS);
if ($idx === false) return null;
$buf[] = $idx;
}
// 逆置换
$restored = array_fill(0, $len, 0);
for ($i = 0; $i < $len; $i++) {
$pos = ($i * 3 + 1) % $len;
$restored[$pos] = $buf[$i];
}
// 转回十进制
$res = 0;
foreach ($restored as $i => $v) {
$res += $v * pow(self::BASE, $len - 1 - $i);
}
return $res > 0 ? $res : null;
}}
立即学习“PHP免费学习笔记（深入）”；
用法示例：InviteCode::encode(12345) → 'K7YX2U'，InviteCode::decode('K7YX2U') → 12345。整个过程不依赖数据库，也不暴露原始 ID 规律。
ThinkPHP 控制器中生成并保存推广二维码
邀请码只是第一步，真正要落地的是「带参数的二维码」。ThinkPHP 不自带二维码生成，需引入 endroid/qr-code 或调用微信小程序接口。常见错误是直接用 QRCode::create() 生成裸 URL，但推广场景必须携带用户标识：
- 如果是 H5 分享，URL 应为
https://xxx.com/register?ref=K7YX2U，注意对ref值做urlencode() - 如果是小程序，必须调用
getUnlimited接口，scene参数最大 32 字节，所以邀请码本身不能超长；建议拼接成u_12345再 base64 编码，而非直接塞K7YX2U - 生成图片后务必用
imagepng()写入服务器，路径建议统一放在public/uploads/qrcode/，并设置好 Web 服务器读取权限 - 别忘了在返回 JSON 前检查文件是否存在，否则前端拿到 404 链接
控制器片段示例：
public function createUserQRcode()
{
$uid = (int)input('uid');
$code = InviteCode::encode($uid);
$url = 'https://yourdomain.com/register?ref=' . urlencode($code);
<pre class="brush:php;toolbar:false;">$path = 'uploads/qrcode/' . $uid . '.png';
$fullPath = public_path($path);
// 使用 endroid/qr-code
$qrCode = QRCode::create($url)
->setSize(300)
->setMargin(10);
file_put_contents($fullPath, $qrCode->getString());
return json(['code' => 0, 'data' => ['qrcode_url' => '/' . $path]]);}
立即学习“PHP免费学习笔记（深入）”；
容易被忽略的边界点
真实上线时最常翻车的地方不在算法，而在细节：
-
invite_code字段在数据库里必须加唯一索引，哪怕你用了可逆算法——因为用户可能手动注册+填别人邀请码，此时仍需校验「该码未被他人使用过」 - 微信
getUnlimited返回的二维码是临时链接，有效期 30 天，且每日调用量有限；不要每次请求都调，应先查缓存或本地文件是否存在，不存在再生成并落盘 - 用户分享后，前端必须用
encodeURIComponent()包裹邀请码再拼 URL，否则含特殊字符（如+、/）会导致后端解析失败 - ThinkPHP 的
input()默认过滤空格和 HTML 标签，但邀请码若含+可能被误截断，建议显式用input('ref/s', '', '')关闭过滤
