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。
控制器传进来的变量
| 键 | 来源 | 是什么 |
|---|---|---|
err | FC:784 | string,空或「用户名或密码错误。」 |
back | FC: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。
控制器传进来的变量
| 键 | 来源 | 是什么 |
|---|---|---|
err | FC:804-818 | string,中文提示 |
old | FC:795、797-800 | 数组,固定两个键 username / email,回显用 |
这一页挂的钩子
| 钩子名 | 触发位置 | 典型用途 |
|---|---|---|
register_form_extra | register.php:33,fire | 无参,插件 echo 追加字段。emailcode 插件的邮箱验证码字段就是这么进来的 |
register_check | FC: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。
控制器传进来的变量
| 键 | 来源 | 是什么 |
|---|---|---|
me | Member::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 |
tabs | FC:873-882 再过 user_tabs | 键值对,index/submit/favorite/profile/password,开投稿加 tougao,可售文章加 buy |
msg | GET 的 ok 加保存后的提示 | string |
submits | Apply::where(user_id = 我) | dtr_apply 行列表,最多 100 条 |
favs | Favorite::listFor($uid) | dtr_list 行列表(SELECT s.*),返回的是站点行不是收藏关系行 |
myStats | 三个 count | ["submit" => int, "passed" => int, "fav" => int] |
tabHtml | user_tab_html 过滤器 | string,HTML。核心自己生成 tougao 与 buy 两块的内容 |
这一页挂的钩子
| 钩子名 | 触发位置 | 典型用途 |
|---|---|---|
user_tabs | FC:887,filter | 参数 [uid],插件加标签页,pay.php:156、bookmark.php:579 都挂这里 |
user_tab_html | FC: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。