7. 逐页拆解:投稿与统计
提交收录、公开待审列表、前台投稿、收录统计、关于我们,一共五页。 这几页的表单字段名是硬约束:提交收录只认 name、url、sort_id、keywords、intro,前台投稿的分类字段必须叫 sortwz_id, 名字写错服务端直接当没填。拆法同第 5 章,每一页都给变量表、钩子表、坑和最小代码。
7.1 apply.php,提交收录
视图文件 views/apply.php
- 这页干什么提交网站收录的表单加收录须知侧栏。游客也能提交,是否先审后发由后台开关定。
- 谁调它
FC::apply()在FC:357渲染,地址/apply.html(Router.php:108)。GET 展示和 POST 提交是同一个方法、同一个地址:POST 处理完在原地重新渲染,只换$msg,不做跳转。 - 代码真读到的变量
$open(7 自建)、$msg(15-16)、$notice(18-19)、$sorts/$s(34-35)。函数用到nl2br()、dtr("qq")、dtr("qqgroup")、ad(2)、Member::check()。 - 文件缺失时回退 default;全缺输出文本
模板不存在:apply.php。
控制器传进来的变量
| 键 | 来源 | 是什么 |
|---|---|---|
sorts | Sort::ordered() | dtr_sort 行列表,给 select 用 |
msg | FC:307-352 各分支 | string,空或中文提示 |
notice | Config::get("apply_notice") | string,后台填的须知正文,视图用 nl2br(e()) 输出 |
open | 视图第 7 行自己读 Config::get("submit_open","1") | bool,不是控制器给的 |
这一页挂的钩子
| 钩子名 | 触发位置 | 典型用途 |
|---|---|---|
front_slot_form_apply | apply.php:44,filter | 返回值直接 echo 在表单里。tdk 插件的「获取 TDK」按钮就是这么挂进来的,它加的是按钮不是字段 |
apply_submitted | FC:348,fire | 参数 [id, apply 行摘要],notify 插件监听后推送 |
text_check | 经 dtr_check_text(),FC:315 | 敏感词过滤器,每个字段一次,scene 是 apply_字段名 |
容易踩的地方
- POST 字段名必须一个不差:
name、url、sort_id、keywords、intro。服务端自己补img、ip、user_id、domain、status、created_at,表单里不要写这些,写了也不认。 - 这页没有 CSRF 令牌、没有蜜罐(25-53 行整个 form 里都没有),防刷只靠域名判重、敏感词和 ip 记录。想加令牌必须连
FC:300一起改,只改模板等于永远提交失败。 - 16 行用
strpos($msg, "成功")决定提示框颜色。敏感词拦截的理由里如果出现「成功」两个字会被标成绿色,写自定义文案时避开。 sort_id的 select 没有预选值;分类为空时只剩「请选择分类」,提交必被必填校验拦下,但表单不报错只回一句文案。- 7 行视图自己读开关、FC 306 行也读同一个开关:视图关的是表单,直接 POST 仍然能打进服务器。改配置项名字要两处同改。
- url 输入框预填了
https://,用户原样提交也能过非空校验,最后落一条畸形 domain 的待审记录,靠人工审核兜底。
最小可用代码
<?php /* views/apply.php */ ?>
<?php $open = \DTR\Core\Config::get('submit_open', '1') === '1'; ?>
<?php if ($msg !== ''): ?>
<div class="msg <?php echo strpos($msg, '成功') !== false ? 'ok' : 'bad'; ?>"><?php echo e($msg); ?></div>
<?php endif; ?>
<?php if ($open): ?>
<form method="post" action="<?php echo url('apply'); ?>">
<label>站点名称 <input name="name" required></label>
<label>所属分类
<select name="sort_id" required>
<option value="">请选择分类</option>
<?php foreach ($sorts as $s): ?><option value="<?php echo (int) $s['id']; ?>"><?php echo e($s['name']); ?></option><?php endforeach; ?>
</select>
</label>
<label>地址 <input name="url" value="https://" required></label>
<label>关键词 <input name="keywords"></label>
<label>介绍 <textarea name="intro" required></textarea></label>
<?php echo \DTR\Core\Hooks::filter('front_slot_form_apply', '', []); ?>
<button type="submit">提交</button>
</form>
<?php else: ?>
<p class="msg bad">当前暂停收站。</p>
<?php endif; ?>
<?php if ($notice !== ''): ?>
<aside class="notice"><?php echo nl2br(e($notice)); ?></aside>
<?php endif; ?>
7.2 daishen.php,公开待审列表
视图文件 views/daishen.php
- 这页干什么把 status=0 正在排队的提交公开列出来,让提交者知道自己排到哪了。
- 谁调它
FC::daishen()在FC:288渲染,地址/daishen.html?page=2(Router.php:109)。翻页是查询串形态。数据来自Apply::status(0, $page, 30),每页 30 条硬编码在 FC:287。 - 代码真读到的变量
$map(7)、$total(12)、$rows(15,20)、循环$r只用 name / sort_id / created_at(22-24),$cur/$pages/$total转给 pager(28),$this(28)。 - 文件缺失时全缺输出
模板不存在:daishen.php。pager 单独缺时列表还在、分页位变一行文字。
控制器传进来的变量
| 键 | 来源 | 是什么 |
|---|---|---|
rows | Apply::status(0, page, 30) | dtr_apply 行列表,全列,只有 status=0 |
total | 同查询的 COUNT | int,待审总数 |
pages | ceil(total/30) | int |
cur | GET 的 page | int,只 max(1, ...) 夹下限,越界不夹回末页 |
map | 视图第 7 行自建 Sort::nameMap() | id 到 name 的映射,不是控制器给的 |
这一页挂的钩子
这一页没留钩子位置,插件想插东西得换挂载点。
容易踩的地方
- 公开页刻意不显示 url 列(20-25 行只 echo 了三个字段),但
SELECT *其实把 url、ip 都查出来了。想加列先想清楚泄不泄密。 - 16 行空态文案是绿色的「审核很及时」,和「系统本来没数据」语义混在一起,别当 bug 改。
$rows为空时不输出 pager(28 行在 else 分支里),翻页越界只能手改 URL,而且越界页显示空列表不纠正$cur。- 23 行
$map[$r["sort_id"]] ?? "-":分类被删后显示占位符而不是报错。 - pager 的 route 传的是
daishen,生成?page=N,和 sort/newest 的路径段形态不同。
最小可用代码
<?php /* views/daishen.php */ ?>
<?php $map = \DTR\Models\Sort::nameMap(); ?>
<p class="sum">正在排队等待审核的提交共 <?php echo (int) $total; ?> 条。</p>
<?php if (!$rows): ?>
<p class="empty">当前没有待审记录,审核很及时。</p>
<?php else: ?>
<table class="tbl">
<tr><th>站点</th><th>分类</th><th>提交时间</th></tr>
<?php foreach ($rows as $r): ?>
<tr>
<td><?php echo e($r['name']); ?></td>
<td><?php echo e($map[(int) $r['sort_id']] ?? '未分类'); ?></td>
<td><?php echo e(substr($r['created_at'], 0, 16)); ?></td>
</tr>
<?php endforeach; ?>
</table>
<?php echo $this->partial('pager', ['cur' => $cur, 'pages' => $pages, 'route' => 'daishen']); ?>
<?php endif; ?>
7.3 tougao.php,前台投稿
视图文件 views/tougao.php
- 这页干什么会员在前台发文章。页面本体只有 30 行,表单和侧栏都由核心拼串函数
article_blocks()生成。 - 谁调它
FC::tougao()在FC:605渲染,地址/tougao.html(Router.php:123)。两道门:开关art_tougao不是 1 时直接 404(FC:546),未登录 302 到/login.html?r=/tougao.html(FC:551)。 - 代码真读到的变量这一页最特殊:视图代码里一个控制器变量都不读。1-30 行只有注释头列了
$err $sorts $old $tips $audit,可执行部分只调url()、article_blocks("tougaoform")(19)、article_blocks("hot")(24)、ad(3)(25)、Hooks::fire(29)。数据经article_ctx()静态盒流进app/core/article.php:469-498的表单生成器。 - 文件缺失时缺 tougao.php 输出
模板不存在:tougao.php。但如果缺的是核心app/core/article.php,19 行会因函数未定义抛 Throwable,被 capture 抓住返回模板渲染错误:...,是另一种表现。
控制器传进来的变量
| 键 | 来源 | 是什么 |
|---|---|---|
err | FC 校验链 | string |
sorts | Sortwz::ordered() | dtr_sortwz 行列表:id, name, alias, icon。注意这是文章分类,和站点分类 dtr_sort 是两套 |
old | FC:554-559 | ["title" => string, "content" => string, "sortwz_id" => int],回显用 |
token | Member::csrf() | 32 位 hex。传了但没有任何地方读它,表单里的令牌走 csrfField() 现签 |
tips | article_setting("art_tougao_tips") | string,投稿须知 |
audit | art_tougao_audit 是否为 1 | bool,决定「等待审核」还是「直接可见」文案 |
hot | Article::hotMonth(10) | dtr_wz 行列表,开关 art_hot 不为 1 时是空数组 |
这一页挂的钩子
| 钩子名 | 触发位置 | 典型用途 |
|---|---|---|
front_slot_detail | tougao.php:29,fire | 无参 |
text_check | FC:572 | 标题与正文各过一次,scene 是 tougao_title / tougao_content |
front_body_end | layout.php:104 | page === "tougao" 时 article.php:608-610 在这里输出富文本编辑器的样式脚本,重写 layout 忘了这个钩子,投稿页编辑器就变成裸 textarea |
容易踩的地方
_token是隐形必需项:表单里没有它,FC:560 的 CSRF 校验永远报「表单已过期」。手写表单要调Member::csrfField()。- 分类字段名必须叫
sortwz_id,写成sort_id会永远报「请选择一个分类」。 - 正文先
Html::clean再数字数(FC:558 在 564 之前):只贴一张图的正文会被算成 0 字拒稿,报错文案是「正文太少」,看着莫名其妙。 - 门槛:标题至少 4 字、正文至少 30 字。免审时成功后跳文章页,需审时跳
/user-tougao.html?ok=投稿已提交,等待站长审核。 $hot可能是空数组,article_blocks("hot")内部已经处理,模板不用再判空。
最小可用代码
<?php /* views/tougao.php,原样照抄默认模板即可,这里只给手写表单版 */ ?>
<?php if (!empty($err)): ?><div class="msg bad"><?php echo e($err); ?></div><?php endif; ?>
<form method="post" action="<?php echo url('tougao'); ?>">
<?php echo \DTR\Core\Member::csrfField(); ?>
<label>标题 <input name="title" value="<?php echo e($old['title'] ?? ''); ?>" required></label>
<label>分类
<select name="sortwz_id" required>
<option value="">请选择分类</option>
<?php foreach ($sorts as $s): ?>
<option value="<?php echo (int) $s['id']; ?>" <?php selected((int) ($old['sortwz_id'] ?? 0), (int) $s['id']); ?>><?php echo e($s['name']); ?></option>
<?php endforeach; ?>
</select>
</label>
<textarea name="content" required><?php echo e($old['content'] ?? ''); ?></textarea>
<p class="tip"><?php echo e($tips); ?></p>
<button type="submit"><?php echo $audit ? '提交待审' : '发布'; ?></button>
</form>
<?php echo article_blocks('hot'); ?>
<?php \DTR\Core\Hooks::fire('front_slot_detail'); ?>
7.4 tongji.php,收录统计
视图文件 views/tongji.php
- 这页干什么四个总量卡,加每个分类的收录数与占比条。
- 谁调它
FC::tongji()在FC:372渲染,地址/tongji.html(Router.php:110),公开无门槛。 - 代码真读到的变量
$sorts(8,21,26)、$cntList(12,32)、$cntSort(13)、$cntWz(14)、$cntApply(15)、循环$s与$c(26,29,32)。 - 文件缺失时全缺输出
模板不存在:tongji.php。
控制器传进来的变量
| 键 | 来源 | 是什么 |
|---|---|---|
cntList | Site::count(status = 1) | int,已收录站点数 |
cntWz | Article::countLive() | int,按 VISIBLE 条件的可见文章数 |
cntSort | Sort::count(1) | int,全部分类 |
cntApply | Apply::count(1) | int,全部提交,含通过与拒绝。首页那个同名键是待审数,两个口径不一样 |
sorts | 视图第 8 行自己查 Sort::ordered() | dtr_sort 行列表,控制器不传 |
这一页挂的钩子
这一页没留钩子位置,插件想插东西得换挂载点。
容易踩的地方
$sorts是视图自己查的,控制器不传。你重写这页忘了第 8 行那句Sort::ordered(),就永远显示「尚未配置分类」的空态。- 26 行在分类循环里逐条
Site::count("sort_id=:i AND status=1"),是 N+1 查询,分类一多这页就慢。新写模板建议一次GROUP BY取完再做映射。 - 32 行的占比有除零保护
$cntList > 0 ? round(...) : 0,删掉会炸。 - 29 行
$c直接 echo 没过 e(),int 无所谓,改成字符串列时记得转义。
最小可用代码
<?php /* views/tongji.php */ ?>
<?php $sorts = \DTR\Models\Sort::ordered(); ?>
<ul class="stat-cards">
<li><b><?php echo (int) $cntList; ?></b><span>已收录站点</span></li>
<li><b><?php echo (int) $cntSort; ?></b><span>分类</span></li>
<li><b><?php echo (int) $cntWz; ?></b><span>文章</span></li>
<li><b><?php echo (int) $cntApply; ?></b><span>累计提交</span></li>
</ul>
<?php if (!$sorts): ?>
<p class="empty">尚未配置分类。</p>
<?php else: ?>
<table class="tbl">
<?php foreach ($sorts as $s): $c = \DTR\Models\Site::count('`sort_id` = :i AND `status` = 1', [':i' => (int) $s['id']]); ?>
<tr>
<td><a href="<?php echo url('sort', ['id' => $s['id'], 'alias' => $s['alias']]); ?>"><?php echo e($s['name']); ?></a></td>
<td><?php echo (int) $c; ?></td>
<td><i style="width:<?php echo $cntList > 0 ? round($c / $cntList * 100) : 0; ?>%"></i></td>
</tr>
<?php endforeach; ?>
</table>
<?php endif; ?>
7.5 about.php,关于我们
视图文件 views/about.php
- 这页干什么正文卡 + 联系方式卡 + 快捷入口。全站最简单的一页。
- 谁调它
FC::about()只有一句render("about", ["page" => "about"])(FC:367),地址/about.html。控制器只给一个 page 键,正文是视图自己从配置读的。 - 代码真读到的变量
$content(7,15,16)、Config::get("email")(31)、dtr("qq")(29)、dtr("qqgroup")(30)、dtr("icp")(32)、dtr_intro()(18)、ad(2)(38)。 - 文件缺失时全缺输出
模板不存在:about.php。
控制器传进来的变量
| 键 | 来源 | 是什么 |
|---|---|---|
page | FC:367 | string,layout 用它拼 SEO 标题 |
content | 视图第 7 行 Config::get("about_content","") | string,后台「站点设置」里的富文本 HTML |
这一页挂的钩子
这一页没留钩子位置,插件想插东西得换挂载点。
容易踩的地方
- 16 行
echo $content不转义是有意的(后台富文本)。反过来说:任何把外部输入写进about_content的路径都是存储型 XSS 通道,插件想做「用户提交的关于页」必须过Html::clean。 - 15-21 行是空态分支:配置为空时走内置的「老李工作室」介绍(统一出自
dtr_intro())。删掉 else,后台留空设置就是一张白卡。 - 32 行
dtr("icp") ?: "-":备案号空时显示占位符而不是留白。 dtr("email")取不到值——dtr()有白名单(helpers.php:33-45),邮箱要走Config::get("email")。- 想给这页多传变量必须回头改
FC:367;extract没有默认值兜底,模板先读后传会报未定义变量。
最小可用代码
<?php /* views/about.php */ ?>
<?php $content = (string) \DTR\Core\Config::get('about_content', ''); ?>
<article class="about">
<?php if ($content !== ''): ?>
<?php echo $content; ?>
<?php else: ?>
<h1><?php echo e(dtr('name')); ?></h1>
<p><?php echo e(dtr_intro()); ?></p>
<?php endif; ?>
</article>
<aside class="contact">
<p>QQ:<b><?php echo e(dtr('qq')); ?></b></p>
<p>群:<b><?php echo e(dtr('qqgroup')); ?></b></p>
<p>邮箱:<b><?php echo e(\DTR\Core\Config::get('email', '')); ?></b></p>
<p>备案:<?php echo e(\DTR\Core\Config::get('icp', '') ?: '未备案'); ?></p>
</aside>
内容有问题去论坛发帖,或直接联系老李 QQ 260468289。