插件简介

本插件为 XiunoX 论坛系统提供通过用户 UID 登录的功能。在原有的邮箱/用户名登录基础上，新增 UID 登录方式，用户可直接输入 UID 号码和密码完成登录。

• 插件名称：UID登录

• 版本：1.0.0

• 适配 XiunoX 版本：1.0

• 插件作者：欧阳（xiunext.com）

功能用途

• 在登录页面的邮箱输入框中，用户除了可以输入邮箱、用户名外，还可以直接输入 UID 号码进行登录

• 自动检测输入内容是否为纯数字且大于 0，若是则按 UID 方式处理登录逻辑

• 登录流程完整包含：IP 黑名单检查、验证码检查、IP 限流检查、UID 维度锁定检查、密码验证、封禁检查

• 用户不存在时统一返回"用户名或密码错误"，避免 UID 枚举攻击

• 登录成功后自动更新登录时间、登录 IP、登录次数，并设置 Session 和 Token

• 登录页面的输入框 placeholder 自动更新为"邮箱 / 用户名 / UID"提示

安装说明

1. 将 xiunext_uid_login 文件夹上传至 XiunoX 的 plugin/ 目录

2. 登录后台，进入「插件管理」

3. 找到「UID登录」插件，点击「安装」

4. 安装完成后，插件自动启用，无需额外配置

5. 前台登录页面即可使用 UID 登录

卸载说明

1. 登录后台，进入「插件管理」

2. 找到「UID登录」插件，点击「卸载」即可

插件文件列表

xiunext_uid_login/
├── conf.json                          # 插件配置文件（名称、版本、钩子注册等）
├── hook/
│   ├── user_login_post_start.php      # 核心：拦截登录请求，实现 UID 登录逻辑
│   ├── user_login_email_after.htm     # 前端：修改登录页输入框 placeholder 提示文字
│   ├── lang_zh_cn_bbs.php            # 简体中文语言包
│   ├── lang_zh_tw_bbs.php            # 繁体中文语言包
│   └── lang_en_us_bbs.php            # 英文语言包

各文件功能说明

安全说明

• UID 登录流程与系统原生登录流程保持一致的安全检查标准

• 包含 IP 黑名单检查、验证码校验、IP 限流、UID 维度锁定等安全机制

• 用户不存在时返回与密码错误相同的提示信息，防止 UID 枚举

• 登录成功后自动 session_regenerate_id(true) 防止会话固定攻击

兼容性

• 无额外依赖，不依赖其他插件

• 不覆盖任何系统文件，通过钩子机制实现功能扩展

• 支持简体中文、繁体中文、英文三种语言