开发文档 ›全部章节 ›逐页拆解 ›逐页拆解:投稿与统计

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。

控制器传进来的变量

键来源是什么
sortsSort::ordered()dtr_sort 行列表,给 select 用
msgFC:307-352 各分支string,空或中文提示
noticeConfig::get("apply_notice")string,后台填的须知正文,视图用 nl2br(e()) 输出
open视图第 7 行自己读 Config::get("submit_open","1")bool,不是控制器给的

这一页挂的钩子

钩子名触发位置典型用途
front_slot_form_applyapply.php:44,filter返回值直接 echo 在表单里。tdk 插件的「获取 TDK」按钮就是这么挂进来的,它加的是按钮不是字段
apply_submittedFC: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 单独缺时列表还在、分页位变一行文字。

控制器传进来的变量

键来源是什么
rowsApply::status(0, page, 30)dtr_apply 行列表,全列,只有 status=0
total同查询的 COUNTint,待审总数
pagesceil(total/30)int
curGET 的 pageint,只 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 抓住返回 模板渲染错误:...,是另一种表现。

控制器传进来的变量

键来源是什么
errFC 校验链string
sortsSortwz::ordered()dtr_sortwz 行列表:id, name, alias, icon。注意这是文章分类,和站点分类 dtr_sort 是两套
oldFC:554-559["title" => string, "content" => string, "sortwz_id" => int],回显用
tokenMember::csrf()32 位 hex。传了但没有任何地方读它,表单里的令牌走 csrfField() 现签
tipsarticle_setting("art_tougao_tips")string,投稿须知
auditart_tougao_audit 是否为 1bool,决定「等待审核」还是「直接可见」文案
hotArticle::hotMonth(10)dtr_wz 行列表,开关 art_hot 不为 1 时是空数组

这一页挂的钩子

钩子名触发位置典型用途
front_slot_detailtougao.php:29,fire无参
text_checkFC:572标题与正文各过一次,scene 是 tougao_title / tougao_content
front_body_endlayout.php:104page === "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。

控制器传进来的变量

键来源是什么
cntListSite::count(status = 1)int,已收录站点数
cntWzArticle::countLive()int,按 VISIBLE 条件的可见文章数
cntSortSort::count(1)int,全部分类
cntApplyApply::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。

控制器传进来的变量

键来源是什么
pageFC:367string,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。