开发文档 ›全部章节 ›逐页拆解 ›逐页拆解:会员与会话

8. 逐页拆解:会员与会话

登录、注册、用户中心三页。这三页的表单地址、字段名和回跳参数都由核心定死, 模板只负责排版;用户中心的标签页还会被插件接管,改之前先把每一页的「谁调它」和「容易踩的地方」读完。

8.1 login.php,会员登录

视图文件 views/login.php

  • 这页干什么一张登录卡加「回跳到哪」的隐藏域。
  • 谁调它FC::login() 在 FC:786 渲染,地址 /login.html?r=/要回跳的路径(Router.php:114)。站内入口:页头的「登录」、投稿页未登录跳转、apply 页提示链接。已登录访问本页直接跳 /user.html(FC:770-772)。
  • 代码真读到的变量只读 $err(10) 与 $back(12),函数用到 e()、url()、dtr("name")。
  • 文件缺失时全缺输出文本 模板不存在:login.php,被 layout 包着;不抛异常,debug 开着也不炸,因为这不是 Throwable。

控制器传进来的变量

键来源是什么
errFC:784string,空或「用户名或密码错误。」
backFC:774 safeBack(request("r"), "/user.html")string,白名单外的值一律回落 /user.html

这一页挂的钩子

这一页没留钩子位置,插件想插东西得换挂载点。

容易踩的地方

  • POST 字段就三个:username、password、隐藏域 r。r 用 REQUEST 读(FC:774),GET 和 POST 都认;删掉隐藏域后 POST 丢 GET,从投稿页跳来的用户回不到原页。
  • 这页没有 CSRF 令牌、没有蜜罐,是设计如此:FC:775-785 压根不校验 CSRF。别照抄投稿页去加 _token。
  • 10 行直接判 $err !== "":控制器少传 err 键就是未定义变量(extract 用的是 EXTR_SKIP,没有默认值兜底)。
  • 禁用账号(status=0)与密码错误共用同一句提示(FC:779、784),排查时别看字面意思。
  • 成功后 Member::login 写会话再 redirect($back),所以你的表单 action 必须是 url("login") 本身,写到别处就没人处理。

最小可用代码

<?php /* views/login.php */ ?>
<?php if ($err !== ''): ?><div class="msg bad"><?php echo e($err); ?></div><?php endif; ?>
<form method="post" action="<?php echo url('login'); ?>">
  <input type="hidden" name="r" value="<?php echo e($back); ?>">
  <label>用户名 <input name="username" required></label>
  <label>密码 <input name="password" type="password" required></label>
  <button type="submit">登录</button>
  <a href="<?php echo url('register'); ?>">没有账号?去注册</a>
</form>

8.2 register.php,会员注册

视图文件 views/register.php

  • 这页干什么注册表单。成功后自动登录并跳 /user.html。
  • 谁调它FC::register() 在 FC:835 渲染,地址 /register.html(Router.php:115)。已登录访问直接跳用户中心(FC:791-793)。
  • 代码真读到的变量$err(10)、$old(14,19,取 username 与 email 两键)。
  • 文件缺失时同 login,输出 模板不存在:register.php。

控制器传进来的变量

键来源是什么
errFC:804-818string,中文提示
oldFC:795、797-800数组,固定两个键 username / email,回显用

这一页挂的钩子

钩子名触发位置典型用途
register_form_extraregister.php:33,fire无参,插件 echo 追加字段。emailcode 插件的邮箱验证码字段就是这么进来的
register_checkFC:812,filter参数 [email, code, username],返回非空字符串即当作错误文案

容易踩的地方

  • POST 字段名固定:username、email、qq、password、password2,可能再加一个 emailcode。密码框改名就静默注册失败:读不到等于空串,直接走「至少 6 位」分支。
  • emailcode 只在装了 emailcode 插件时存在,模板不能把它写成 required,否则没装插件的站点浏览器拦提交。默认模板把它交给钩子(33 行)是对的做法。
  • 14、19 行直接取 $old["username"]、$old["email"]:old 少任一键就报未定义索引。别在别处自己拼 old。
  • 邮箱格式和重复都没校验:User::emailExists 在注册流程里根本没被调用,邮箱可留空原样入库。别以为填了邮箱就能找回密码。
  • 同样没有 CSRF,注册页漏 _token 不是 bug。Member::csrf() 只服务投稿、打赏、购买。

最小可用代码

<?php /* views/register.php */ ?>
<?php if ($err !== ''): ?><div class="msg bad"><?php echo e($err); ?></div><?php endif; ?>
<form method="post" action="<?php echo url('register'); ?>">
  <label>用户名 <input name="username" value="<?php echo e($old['username'] ?? ''); ?>" required></label>
  <label>邮箱 <input name="email" type="email" value="<?php echo e($old['email'] ?? ''); ?>"></label>
  <label>QQ <input name="qq"></label>
  <label>密码 <input name="password" type="password" required></label>
  <label>确认密码 <input name="password2" type="password" required></label>
  <?php \DTR\Core\Hooks::fire('register_form_extra'); ?>
  <button type="submit">注册</button>
</form>

8.3 user.php,用户中心

视图文件 views/user.php

  • 这页干什么统计卡、我的提交、我的收藏、账号资料、修改密码,另外接插件的 tab(钱包、已购、书签等)和核心的投稿/已购列表。
  • 谁调它FC::user($tab) 在 FC:902 渲染,两个地址形态:/user.html(tab 默认 index)和 /user-xxx.html(Router.php:117-118,正则 #^/user-([a-z]+)\.html$#),tab 名就是路径段。未登录先 302 到 /login.html?r=/user.html 再 exit。
  • 代码真读到的变量$me、$tab、$tabs、$msg、$tabHtml、$myStats、$submits、$favs,外加三个视图自建的 $sortMap(5)、$st(6)、$recent(56)。后三个不是控制器给的,是这一页自己查库拼出来的。
  • 文件缺失时全缺输出 模板不存在:user.php。

控制器传进来的变量

键来源是什么
meMember::current() 即 User::find($uid)dtr_user 整行:id, username, password(hash), email, qq, nickname, avatar, points, level, status, reg_ip, reg_time, last_login
tab路径段string
tabsFC:873-882 再过 user_tabs键值对,index/submit/favorite/profile/password,开投稿加 tougao,可售文章加 buy
msgGET 的 ok 加保存后的提示string
submitsApply::where(user_id = 我)dtr_apply 行列表,最多 100 条
favsFavorite::listFor($uid)dtr_list 行列表(SELECT s.*),返回的是站点行不是收藏关系行
myStats三个 count["submit" => int, "passed" => int, "fav" => int]
tabHtmluser_tab_html 过滤器string,HTML。核心自己生成 tougao 与 buy 两块的内容

这一页挂的钩子

钩子名触发位置典型用途
user_tabsFC:887,filter参数 [uid],插件加标签页,pay.php:156、bookmark.php:579 都挂这里
user_tab_htmlFC:901,filter参数 [tab, uid],插件出该标签页的内容 HTML

容易踩的地方

  • 两个表单,两个不同地址:资料表单 POST 到 /user-profile.html,字段 nickname、email、qq;密码表单 POST 到 /user-password.html,字段 old、new。两个都没有 CSRF 令牌,处理端也不校验(FC:851-870),靠会话 Cookie 鉴权;想加令牌要两边同时改。
  • tab 名只能是纯小写字母(Router.php:117)。插件注册 my_orders 这种带下划线或数字的 tab,url("user", ["tab" => ...]) 能拼出地址但路由匹配不上,点进去 404。
  • 34 行的分支优先级:if ($tabHtml !== "") ... elseif ($tab === "index")。插件只要给出了 tabHtml,五个原生内容块全部不显示,「最近提交」那段(视图自己查的 56 行)也跟着不跑。
  • Favorite::listFor() 不带 status 过滤(Favorite.php:27-31):站点被下架后收藏列表仍然显示它,109 行还照样链向详情页。
  • 6 行的状态字典 $st 只有 0/1/2 三项,取不中走 ?? ["未知", "badge-wait"] 兜底(62、84 行)。
  • 会员中心显示的是 reg_time,不是 created_at——这张表没有 created_at 列。

最小可用代码

<?php /* views/user.php,只给外壳与两个表单 */ ?>
<?php if ($msg !== ''): ?><div class="msg ok"><?php echo e($msg); ?></div><?php endif; ?>

<div class="uc-head">
  <b><?php echo e($me['nickname'] ?: $me['username']); ?></b>
  <span>注册于 <?php echo e(substr($me['reg_time'], 0, 10)); ?></span>
  <span>提交 <?php echo (int) $myStats['submit']; ?></span>
  <span>收藏 <?php echo (int) $myStats['fav']; ?></span>
</div>

<nav class="uc-tabs">
  <?php foreach ($tabs as $k => $label): ?>
    <a class="<?php echo $k === $tab ? 'on' : ''; ?>" href="<?php echo url('user', ['tab' => $k]); ?>"><?php echo e($label); ?></a>
  <?php endforeach; ?>
</nav>

<?php if ($tabHtml !== ''): ?>
  <?php echo $tabHtml; ?>
<?php elseif ($tab === 'profile'): ?>
  <form method="post" action="<?php echo url('user', ['tab' => 'profile']); ?>">
    <label>昵称 <input name="nickname" value="<?php echo e($me['nickname']); ?>"></label>
    <label>邮箱 <input name="email" value="<?php echo e($me['email']); ?>"></label>
    <label>QQ <input name="qq" value="<?php echo e($me['qq']); ?>"></label>
    <button type="submit">保存</button>
  </form>
<?php elseif ($tab === 'password'): ?>
  <form method="post" action="<?php echo url('user', ['tab' => 'password']); ?>">
    <label>原密码 <input name="old" type="password" required></label>
    <label>新密码 <input name="new" type="password" required></label>
    <button type="submit">修改</button>
  </form>
<?php elseif ($tab === 'favorite'): ?>
  <ul class="fav-list">
    <?php foreach ($favs as $f): ?>
      <li><a href="<?php echo url('site', ['id' => $f['id']]); ?>"><?php echo e($f['name']); ?></a></li>
    <?php endforeach; ?>
  </ul>
<?php else: ?>
  <table class="tbl">
    <?php foreach ($submits as $r): ?>
      <tr><td><?php echo e($r['name']); ?></td><td><?php echo (int) $r['status']; ?></td></tr>
    <?php endforeach; ?>
  </table>
<?php endif; ?>

内容有问题去论坛发帖,或直接联系老李 QQ 260468289。