开发文档 ›全部章节 ›数据表与字段 ›数据表与字段

4. 数据表与字段

视图里那些数组的键,就是这些表的列名。核心所有取数都是 SELECT *,一列不裁, 所以你照下面这张字典取用就绝对安全。反过来要注意:你自己写插件取数时别只 SELECT 几列, 少一列视图就报 Undefined index。

4.1 dtr_list,站点表

导航站的主角。表名是 dtr_list,模型叫 Site,代码里 {{list}} 是表前缀占位。

列类型是什么模板里注意
idint 站点 ID,主键拼地址用它:url("site", ["id" => $s["id"]]),别名机制在核心这边
sort_idint 所属分类 ID,对应 dtr_sort.id分类被删了它不会跟着清,取分类名一定用 $map[$row["sort_id"]] ?? "未分类"
namevarchar(200) 站点名列表页直接输出,别自己截断,用 cut($s["name"], 12, "…")
domainvarchar(200) 小写、去了 www 的主机名核心用 Site::domainOf() 从 url 推出来存着的,展示和外链都推荐用它
urlvarchar(500) 原始地址前台一律走跳转链 url("go", ["id" => $s["id"]]) 出去,别裸输出这一列:裸输出不计浏览量、也不走审核开关
imgvarchar(500) 站点 logo 图,存的是相对路径,空串表示没有判空再输出,$s["img"] 非空才渲染图片标签。想优先用截图服务就调 site_shot_url($s)
aliasvarchar(100) 站点别名,可空有值时规范地址用它,没值核心自动退回 id 段
keywordsvarchar(500) SEO 关键词layout.php:16 读它拼 <meta keywords>
descriptionvarchar(500) SEO 描述列表页摘要首选它,空则退到 intro
introtext 站点介绍,正文级长文本老写法固定是 $s["description"] ?: $s["intro"],两个键都要有
viewint 总浏览量排行榜、搜索排序都按它,Site::search 的 ORDER BY view DESC
hitsint 当月浏览量跨月自动从 1 重计,见 Site::addView() 里的 IF(`datem` = 本月, hits+1, 1)
rhitsint 当天浏览量同上按天滚,日榜用它
last_hitint 最近一次被访问的 unix 时间戳,0 表示从没有首页「最近来访」= Site::recentHits(),条件是 last_hit > 0,按它倒序
datevarchar(10) 最后计数那天,形如 2026-01-08别当收录日期用,收录时间是 created_at
datemvarchar(7) 最后计数那月,形如 2026-01同上
is_tuitinyint 1 推荐位列表排序固定 is_tui DESC, id DESC,推荐站永远冒到前面
statustinyint 1 已收录 0 未收录前台所有查询都带 status = 1,你自己写控制器取数也必须带上,否则待审站点会漏出来
created_atdatetime 收录时间展示用 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 / parentint分类 ID 与父分类,0 是一级
namevarchar(100)分类名
aliasvarchar(100)别名,规范地址 /list/别名.html 用的就是它
iconvarchar(100)图标,可以是 emoji 或 class 名
sort_orderint排序值,小的在前
created_atdatetime建分类时间

4.3 dtr_wz,文章表

模型叫 Article,文章分类是另一套表 dtr_sortwz。前台能不能看见一篇文章, 全看这条 SQL 条件:(`status` = 1 OR (`status` = 3 AND `publish_at` <= NOW())), 常量 Article::VISIBLE。定时发布到点自动可见,不改状态。

列类型是什么模板里注意
id / sortwz_idint 文章 ID 与文章分类 ID分类表是 dtr_sortwz,和站点分类 dtr_sort 是两套,别混
titlevarchar(255) 标题
aliasvarchar(100) 文章别名,可空同上,空则地址用 id
keywords / descriptionvarchar(500) SEO 两项layout 拼标题描述会读
imgvarchar(500) 封面图判空再输出
contentlongtext 正文 HTML,入库前已过 Html::clean 白名单前台直接 echo $article["content"],不要再 e(),否则满屏实体码
view / hits / rhitsint 总 / 当月 / 当天浏览口径和站点表一模一样,按天按月自动重计
date / datemvarchar 最后计数那天、那月不是发布时间,发布时间看 publish_at
likesint 点赞数点赞过没赞过记在 dtr_wz_like,模板里想禁用重复点赞要查它
is_tuitinyint 推荐位
statustinyint 0 草稿 1 已发布 2 待审 3 定时发布 4 已下架前台可见的唯一判据是 Article::VISIBLE 那段条件
publish_atdatetime 发布时间定时发布到点自动可见,靠的是查询条件直接比 NOW(),不需要计划任务改状态
uidint 作者的用户 ID,0 是管理员发的投稿来的文章这里是人
priceint 付费阅读价,单位分,0 免费付费逻辑在插件里,模板只管显示价格徽标
tip_ontinyint 是否开启打赏
vistinyint 可见性开关配合 min_level 做等级限制
min_leveltinyint 最低可见等级
created_atdatetime 创建时间

4.4 dtr_apply 投稿、dtr_user 会员

列类型是什么模板里注意
id / sort_idint 申请 ID、想进的分类
name / url / domain / img / keywords / intro 和站点表同名的那几列,是投稿时填的原始值待审列表 daishen.php 展示的就是这些
statustinyint 0 待审 1 通过 2 拒绝Apply::status(0,页,条数) 取待审;重复提交判重只看 status IN (0,1)
ipvarchar(50) 提交者 IP
user_idint 提交者用户 ID,游客是 0会员中心「我的提交」按它查
created_atdatetime 提交时间
id / username / password 账号,password 是 password_hash 的串永远别输出这一列
email / qq / nickname / avatar 资料项显示名统一写法:$me["nickname"] ?: $me["username"]
points / levelint / tinyint 积分与等级文章按等级可见时用得上
statustinyint 1 正常 0 禁用禁用号登录报错和密码错是同一句提示
reg_ip / reg_time / last_login 注册与登录痕迹会员中心显示的是 reg_time,不是 created_at

4.5 其余几张表

表列干什么
dtr_navid, name, url, icon, sort_order 顶部导航菜单。Nav::ordered() 按 sort_order 排;地址用 nav_url($n["url"]) 处理,站内站外都能填
dtr_noticeid, content, created_at 站内公告。Notice::latest(3) 取最新三条,前台首页那条公告条取 [0]
dtr_linkid, name, url 友情链接。没有排序列,Link::ordered() 按 id 排
dtr_sortwzid, name, alias, icon 文章分类,Sortwz::ordered()
dtr_ztid, name, alias, description, img, status, sort_order, created_at 专题
dtr_zt_wzzt_id, wz_id, xuhao 专题与文章的关联,xuhao 是专题内排序
dtr_favoriteid, user_id, site_id, created_at 收藏关系表。注意 Favorite::listFor() 返回的是站点行不是关系行
dtr_tpl模板名 + config 列 JSON 模板配置,后台改过的值存这里,覆盖你包里的 Config.php 默认值
dtr_configname, value 站点配置键值表。Config::get("键") 或视图里 cfg 数组读

表名前缀不一定是 dtr_,安装时可以改。所以你自己写插件取数一律用 {{list}} 这种占位写法,核心 Database 会替换;千万不要在插件里硬写 dtr_list, 换前缀的站点装上就白屏。

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