# 數據庫
很多時候我們的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維護
- 插件開發
- 目錄結構
- 數據庫
- 測試數據
- 插件信息
- 插件配置
- 核心文件
- 插件函數
- ??開發者入駐
- 申請入駐
- 建立私庫
- 插件入駐流程
- 模板入駐流程
- 安全建議
- 更新日記和補丁包