4. 数据表与字段
视图里那些数组的键,就是这些表的列名。核心所有取数都是 SELECT *,一列不裁,
所以你照下面这张字典取用就绝对安全。反过来要注意:你自己写插件取数时别只 SELECT 几列,
少一列视图就报 Undefined index。
4.1 dtr_list,站点表
导航站的主角。表名是 dtr_list,模型叫 Site,代码里 {{list}} 是表前缀占位。
| 列 | 类型 | 是什么 | 模板里注意 |
|---|---|---|---|
id | int | 站点 ID,主键 | 拼地址用它:url("site", ["id" => $s["id"]]),别名机制在核心这边 |
sort_id | int | 所属分类 ID,对应 dtr_sort.id | 分类被删了它不会跟着清,取分类名一定用 $map[$row["sort_id"]] ?? "未分类" |
name | varchar(200) | 站点名 | 列表页直接输出,别自己截断,用 cut($s["name"], 12, "…") |
domain | varchar(200) | 小写、去了 www 的主机名 | 核心用 Site::domainOf() 从 url 推出来存着的,展示和外链都推荐用它 |
url | varchar(500) | 原始地址 | 前台一律走跳转链 url("go", ["id" => $s["id"]]) 出去,别裸输出这一列:裸输出不计浏览量、也不走审核开关 |
img | varchar(500) | 站点 logo 图,存的是相对路径,空串表示没有 | 判空再输出,$s["img"] 非空才渲染图片标签。想优先用截图服务就调 site_shot_url($s) |
alias | varchar(100) | 站点别名,可空 | 有值时规范地址用它,没值核心自动退回 id 段 |
keywords | varchar(500) | SEO 关键词 | layout.php:16 读它拼 <meta keywords> |
description | varchar(500) | SEO 描述 | 列表页摘要首选它,空则退到 intro |
intro | text | 站点介绍,正文级长文本 | 老写法固定是 $s["description"] ?: $s["intro"],两个键都要有 |
view | int | 总浏览量 | 排行榜、搜索排序都按它,Site::search 的 ORDER BY view DESC |
hits | int | 当月浏览量 | 跨月自动从 1 重计,见 Site::addView() 里的 IF(`datem` = 本月, hits+1, 1) |
rhits | int | 当天浏览量 | 同上按天滚,日榜用它 |
last_hit | int | 最近一次被访问的 unix 时间戳,0 表示从没有 | 首页「最近来访」= Site::recentHits(),条件是 last_hit > 0,按它倒序 |
date | varchar(10) | 最后计数那天,形如 2026-01-08 | 别当收录日期用,收录时间是 created_at |
datem | varchar(7) | 最后计数那月,形如 2026-01 | 同上 |
is_tui | tinyint | 1 推荐位 | 列表排序固定 is_tui DESC, id DESC,推荐站永远冒到前面 |
status | tinyint | 1 已收录 0 未收录 | 前台所有查询都带 status = 1,你自己写控制器取数也必须带上,否则待审站点会漏出来 |
created_at | datetime | 收录时间 | 展示用 substr($s["created_at"], 0, 10) |
浏览量的口径务必记牢,这是被问得最多的一个:view 只增不减的总数,
hits 当月、rhits 当天,跨期在 Site::addView() 里用一句
IF(`date` = 今天, rhits + 1, 1) 自动归零重计,不需要计划任务。
date 和 datem 是最后计数那天那月,不是收录日期,收录日期是 created_at。
4.2 dtr_sort,站点分类
| 列 | 是什么 | 模板里注意 |
|---|---|---|
id / parent | int | 分类 ID 与父分类,0 是一级 |
name | varchar(100) | 分类名 |
alias | varchar(100) | 别名,规范地址 /list/别名.html 用的就是它 |
icon | varchar(100) | 图标,可以是 emoji 或 class 名 |
sort_order | int | 排序值,小的在前 |
created_at | datetime | 建分类时间 |
4.3 dtr_wz,文章表
模型叫 Article,文章分类是另一套表 dtr_sortwz。前台能不能看见一篇文章,
全看这条 SQL 条件:(`status` = 1 OR (`status` = 3 AND `publish_at` <= NOW())),
常量 Article::VISIBLE。定时发布到点自动可见,不改状态。
| 列 | 类型 | 是什么 | 模板里注意 |
|---|---|---|---|
id / sortwz_id | int | 文章 ID 与文章分类 ID | 分类表是 dtr_sortwz,和站点分类 dtr_sort 是两套,别混 |
title | varchar(255) | 标题 | |
alias | varchar(100) | 文章别名,可空 | 同上,空则地址用 id |
keywords / description | varchar(500) | SEO 两项 | layout 拼标题描述会读 |
img | varchar(500) | 封面图 | 判空再输出 |
content | longtext | 正文 HTML,入库前已过 Html::clean 白名单 | 前台直接 echo $article["content"],不要再 e(),否则满屏实体码 |
view / hits / rhits | int | 总 / 当月 / 当天浏览 | 口径和站点表一模一样,按天按月自动重计 |
date / datem | varchar | 最后计数那天、那月 | 不是发布时间,发布时间看 publish_at |
likes | int | 点赞数 | 点赞过没赞过记在 dtr_wz_like,模板里想禁用重复点赞要查它 |
is_tui | tinyint | 推荐位 | |
status | tinyint | 0 草稿 1 已发布 2 待审 3 定时发布 4 已下架 | 前台可见的唯一判据是 Article::VISIBLE 那段条件 |
publish_at | datetime | 发布时间 | 定时发布到点自动可见,靠的是查询条件直接比 NOW(),不需要计划任务改状态 |
uid | int | 作者的用户 ID,0 是管理员发的 | 投稿来的文章这里是人 |
price | int | 付费阅读价,单位分,0 免费 | 付费逻辑在插件里,模板只管显示价格徽标 |
tip_on | tinyint | 是否开启打赏 | |
vis | tinyint | 可见性开关 | 配合 min_level 做等级限制 |
min_level | tinyint | 最低可见等级 | |
created_at | datetime | 创建时间 |
4.4 dtr_apply 投稿、dtr_user 会员
| 列 | 类型 | 是什么 | 模板里注意 |
|---|---|---|---|
id / sort_id | int | 申请 ID、想进的分类 | |
name / url / domain / img / keywords / intro | 和站点表同名的那几列,是投稿时填的原始值 | 待审列表 daishen.php 展示的就是这些 | |
status | tinyint | 0 待审 1 通过 2 拒绝 | Apply::status(0,页,条数) 取待审;重复提交判重只看 status IN (0,1) |
ip | varchar(50) | 提交者 IP | |
user_id | int | 提交者用户 ID,游客是 0 | 会员中心「我的提交」按它查 |
created_at | datetime | 提交时间 | |
id / username / password | 账号,password 是 password_hash 的串 | 永远别输出这一列 | |
email / qq / nickname / avatar | 资料项 | 显示名统一写法:$me["nickname"] ?: $me["username"] | |
points / level | int / tinyint | 积分与等级 | 文章按等级可见时用得上 |
status | tinyint | 1 正常 0 禁用 | 禁用号登录报错和密码错是同一句提示 |
reg_ip / reg_time / last_login | 注册与登录痕迹 | 会员中心显示的是 reg_time,不是 created_at |
4.5 其余几张表
| 表 | 列 | 干什么 |
|---|---|---|
dtr_nav | id, name, url, icon, sort_order |
顶部导航菜单。Nav::ordered() 按 sort_order 排;地址用 nav_url($n["url"]) 处理,站内站外都能填 |
dtr_notice | id, content, created_at |
站内公告。Notice::latest(3) 取最新三条,前台首页那条公告条取 [0] |
dtr_link | id, name, url |
友情链接。没有排序列,Link::ordered() 按 id 排 |
dtr_sortwz | id, name, alias, icon |
文章分类,Sortwz::ordered() |
dtr_zt | id, name, alias, description, img, status, sort_order, created_at |
专题 |
dtr_zt_wz | zt_id, wz_id, xuhao |
专题与文章的关联,xuhao 是专题内排序 |
dtr_favorite | id, user_id, site_id, created_at |
收藏关系表。注意 Favorite::listFor() 返回的是站点行不是关系行 |
dtr_tpl | 模板名 + config 列 JSON |
模板配置,后台改过的值存这里,覆盖你包里的 Config.php 默认值 |
dtr_config | name, value |
站点配置键值表。Config::get("键") 或视图里 cfg 数组读 |
表名前缀不一定是 dtr_,安装时可以改。所以你自己写插件取数一律用
{{list}} 这种占位写法,核心 Database 会替换;千万不要在插件里硬写 dtr_list,
换前缀的站点装上就白屏。
内容有问题去论坛发帖,或直接联系老李 QQ 260468289。