# 数据库
很多时候我们的YznCMS插件都需要使用到数据库,此章节为你解答如何在YznCMS插件中使用数据库功能。
## 设计规范
我们在设计插件数据库时建议统一设计规范,因为更好的设计规范能更好的让我们的用户更快速的掌握我们开发者的设计思想。
1. 表名和字段名全小写,只允许出现`a-z`和`_`这几种字符,且不能有拼音,只能为英文单词
2. 字符集统一使用`utf8mb4`,排序规则使用`utf8mb4_general_ci`
3. 关联字段统一使用`_id`结尾,如`user_id`、`task_id`(任务表名为task),`item_id`(物品表名为item), 当为`father_id`、`parent_id`、`pid`、`prev_id`等字段时表示和当前表主键进行关联,当为`task_ids`、`user_ids`时表示一个集合,以半角逗号进行分隔(非JSON)
4. 时间统一使用`Unix时间戳`格式, 秒级, 长整型, 长度16,且必须以`time`结尾, 如`create_time`、`update_time`,`pay_time`、`expire_time`等
5. 时长统一使用秒格式, 整型, 长度10,且必须以`seconds`结尾,如`onlineseconds`、`todayonlineseconds`等
6. 表主键必须为`id`,主索引
7. 表名和字段名统一使用英文名称,不允许出现中英混搭的情况出现
8. 日志表统一为模块名加上`_log`进行命名
9. 字段内容为`json`数据时,以`data`进行结尾,比如`itemdata`、`rewarddata`
10. 当字段为某操作数量时,以`nums`结尾,比如`buynums`、`salenums`
11. 当一表出现两个或两个以上会员ID时,`user_id`表示自己,`receiver_user_id`表示他人,多人时使用`receiver_user_ids`,以半角逗号进行分隔(非JSON)
12. 当出现可数名词字段时,一定要加上字符`s`,如`comments`、`views`等
13. 数据表添加的索引对应的字段长度不建议超过100
## 配置文件
在插件目录`addons/mydemo`目录添加一个`install.sql`,然后将安装脚本的SQL存放在此文件中。
## 数据表名规范
插件数据表名必须以`插件标识`开始,例如:
~~~markdown
__PREFIX__mydemo
__PREFIX__mydemo_log
__PREFIX__mydemo_comment
~~~
其中`mydemo`为你的插件标识,`__PREFIX__`为数据表前缀。
## 测试数据
每个插件可自带一个`testdata.sql`,用于安装插件成功后导入测试数据,具体文档请参考`测试数据`章节。
- 序言
- 使用条款
- 安装
- 环境搭建
- 目录结构
- 钩子和行为
- 表单生成
- 数据限制
- 命令行
- 一键生成CRUD
- 一键生成菜单
- 一键安装
- 系统配置
- 常规字段
- 特殊字段1:下拉框(高级)字段
- 特殊字段2:自定义字段
- 特殊字段3:自定义多图片
- 系统函数/类
- 函数说明
- cache - 缓存管理
- thumb - 获取缩略图
- str_cut - 字符截取
- 邮箱/短信
- 插件使用说明
- cms内容管理【cms】
- 变量/常量
- 函数
- getCategory - 栏目获取
- catpos - 面包屑
- seo - 生成SEO
- buildCatUrl - 生成栏目URL
- buildContentUrl - 创建内容链接
- 标签
- 公共参数
- 栏目标签
- 列表标签
- 上一页标签
- 下一页标签
- Tags标签
- 万能标签
- 原生标签
- 搜索页
- 筛选页
- 内容详情页
- 模板
- 技巧/问题
- 将CMS路由设置更简洁
- 外链和单页如何增加列表类型的子栏目
- 如何合理设置SEO
- 实现电脑和手机模板分离
- 敏感词检测
- 栏目授权不全
- 内容页分页
- 分页伪静态
- tag标签不支持特殊字符
- 部分虚拟主机tags页面报错
- 循环表格
- 二级目录搭建知识点
- 阅读收费
- 会员插件【member】
- 介绍
- 自定义表单【formguide】
- 调用方式
- 模板
- 支付插件【pay】
- 支付宝
- 微信
- 常见问题
- 接口文档【apidoc】
- 简介
- 配置
- 使用
- 万能采集【collection】
- 采集列表规则
- 采集内容规则
- 关于图片
- 案例一:采集yzncms论坛
- cms小程序【wxcms】(重构已下架)
- 前端
- H5设计【diywap】
- 返回顶部【returntop】
- 通用数据导出【dataoutput】
- 多通道短信【easysms】
- 塞邮邮箱【saiyouems】
- 第三方登录【synclogin】
- 中文分词【getwords】
- QQ客服【kefu】
- 地图位置【address】
- 智能人机验证【vaptcha】
- 行为验证码【ajcaptcha】
- 数据转换【v9toyzn】
- 数据转换【dedetoyzn】
- 百度收录查询【baidurecord】
- 蜘蛛访问统计【spider】
- editormd编辑器【editormd】
- 敏感词检测【sensitive】
- 邮箱发送【phpmailer】
- 内容收藏【favorite】
- 队列插件【queue】
- 七牛云【qiniu】
- 阿里云oss【alioss】
- 腾讯云【cos】
- 迅搜全文检索【xunsearch】
- 评论插件【comments】
- 网页即时通讯【webim】(重构已下架)
- 生成js
- window使用
- linux使用(推荐)
- 常见问题
- 友情链接【links】
- 考试插件【kaoshi】(暂停)
- 会员邀请【invite】
- 快递查询插件【expressquery】
- 礼品卡提货系统【pickup】
- 地区插件【area】
- IP归属地查询【ipregion】
- 百度统计插件【baidutongji】
- 消息通知【notice】
- 微信管理【wechat】
- 在线投票系统【vote】
- 前端&组件
- 后台前端框架
- 文件上传
- table数据表格
- auth权限验证
- 动态显示(Favisible)
- 动态下拉(SelectPage)
- 键值组件(Fieldlist)
- uniapp教程
- 常见问题
- YznCMS开发遇到错误怎么办?(新手必看)
- 关闭调试模式
- 伪静态(URL重写)
- 虚拟主机不支持绑定public的方法
- 各类虚拟主机伪静态使用注意事项
- 百度编辑器多图片上传被压缩
- 部分虚拟主机隐藏index.php有问题
- 后台路径admin.php修改
- 后台密码忘记重置方法
- 宝塔面板一键部署
- 后台登录时验证码不显示
- 小程序图片不显示
- 如何自定义404页面显示模板
- 管理员登录时提示请于1天后再尝试登录
- composer
- composer简介
- 内置composer
- 各大厂商镜像地址
- 常用命令
- 拓展知识
- 助手类
- thinkphp维护
- 插件开发
- 目录结构
- 数据库
- 测试数据
- 插件信息
- 插件配置
- 核心文件
- 插件函数
- 🔥开发者入驻
- 申请入驻
- 建立私库
- 插件入驻流程
- 模板入驻流程
- 安全建议
- 更新日记和补丁包