# 数据库
很多时候我们的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`,用于安装插件成功后导入测试数据,具体文档请参考`测试数据`章节。
- 与1.4版本差异说明
- 序言
- 使用条款
- 安装
- 环境搭建
- 事件
- 表单生成
- 数据限制
- 命令行
- 一键生成CRUD
- 一键生成菜单
- 一键安装
- 一键压缩打包
- 系统配置
- 常规字段
- 特殊字段1:高级下拉框[selectpage]
- 特殊字段2:自定义字段
- 特殊字段3:自定义多图片
- 邮箱/短信类
- 前端&组件
- 后台前端框架
- 文件上传
- table数据表格
- auth权限验证
- 动态显示(Favisible)
- 动态下拉(SelectPage)
- 键值组件(Fieldlist)
- 标签输入
- uniapp教程
- 🔥插件使用说明
- cms内容管理【cms】
- 变量/常量
- 函数
- getCategory - 栏目获取
- catpos - 面包屑
- seo - 生成SEO
- buildCatUrl - 生成栏目URL
- buildContentUrl - 创建内容链接
- 标签
- 公共参数
- 栏目标签
- 列表标签
- 上一页标签
- 下一页标签
- Tags标签
- 万能标签
- 原生标签
- 搜索页
- 筛选页
- 内容详情页
- 模板
- 技巧/问题
- 敏感词检测
- 栏目授权不全
- 循环表格
- 部分虚拟主机tags页面报错
- 内容页分页
- 分页伪静态
- 实现电脑和手机模板分离
- 阅读收费
- 友情链接【links】
- 自定义表单【formguide】
- 调用方式
- 支付插件【pay】
- 支付宝
- 微信
- 万能采集【collection】
- 采集列表规则
- 采集内容规则
- 关于图片
- H5设计【diywap】
- 接口文档【apidoc】
- 返回顶部【returntop】
- 通用数据导出【dataoutput】
- 通用数据导入【dataimport】
- 多通道短信【easysms】
- 塞邮邮箱【saiyouems】
- 第三方登录【synclogin】
- 中文分词【getwords】
- QQ客服【kefu】
- 地图位置【address】
- 智能人机验证【vaptcha】
- 数据转换【v9toyzn】
- 数据转换【dedetoyzn】
- 百度收录查询【baidurecord】
- 蜘蛛访问统计【spider】
- editormd编辑器【editormd】
- Easymde编辑器【easymde】
- 百度ueditor插件【ueditor】
- 敏感词检测【sensitive】
- 邮箱发送【phpmailer】
- 内容收藏【favorite】
- 队列插件【queue】
- 七牛云【qiniu】
- 阿里云oss【alioss】
- 腾讯云【cos】
- 迅搜全文检索【xunsearch】
- 评论插件【comments】
- 会员邀请【invite】
- 快递查询插件【expressquery】
- 礼品卡提货系统【pickup】
- 地区插件【area】
- IP归属地查询【ipregion】
- 百度统计插件【baidutongji】
- 消息通知【notice】
- 微信管理【wechat】
- 在线投票系统【vote】
- 图片处理【imgproc】
- 后台登录主题【adminlogin】
- 文档管理系统【docs】
- 频率限制【throttle】
- 2FA双因子验证【twofas】
- 🔥开发者入驻
- 申请入驻
- 建立私库
- 插件入驻流程
- 模板入驻流程
- 🔥插件开发
- 目录结构
- 数据库
- 测试数据
- 插件信息
- 插件配置
- 核心文件
- 插件函数
- 常见问题
- YznCMS开发遇到错误怎么办?(新手必看)
- 开启调试模式
- 伪静态(URL重写)
- 如何去除访问链接中的index.php
- 各类虚拟主机伪静态使用注意事项
- 如何自定义404页面显示模板
- 管理员登录时提示请于1天后再尝试登录
- 宝塔面板一键部署
- 后台登录时验证码不显示
- 后台密码忘记重置方法
- 关于编辑器的一些说明
- 如何重置后台登录地址
- 如何修改或禁用左侧菜单栏的角标
- composer
- composer简介
- 内置composer
- 常用命令
- 安全建议
- 更新日记和补丁包