# 數據庫規范(草案) ## 表規范 * 命名統一小寫下劃線 * 非CMF核心應用，統一帶應用表前綴，如portal_ * 插件表，統一帶插件表前綴，如:plugin_demo_ * 表默認編碼utf8mb4,默認排序規則utf8mb4_general_ci * 引擎統一innodb * 寫表注釋 ## 字段規范 * 命名統一小寫下劃線 * 非自增主鍵一定要寫字段注釋 * 數據類型盡量用數字類型，數字類型的比字符類型的要快很多。 * 數據類型盡量小，這里的盡量小是指在滿足可以預見的未來需求的前提下的,但是又不能太小 * 盡量不要允許NULL * 布爾類型的值均以 is、has、exist 或者 can開頭 * create_time作為記錄創建時間 * update_time作為記錄更新時間 * delete_time作為記錄軟刪除時間 * 需要軟刪除的表統一加delete_time字段 * status表示記錄狀態 * table_name作為表名，字段varchar長度64 * remark代表備注，給管理員區分記錄類型用 * description代表描述給前臺用戶用 * list_order代表記錄排序字段，類型float,默認值10000，默認排序按從小到大 * image 代表圖片,thumbnail 代表縮略圖,photos代表相冊 * 固定長度的字符串用char不用varchar * more代表表擴展屬性，text類型 * 除user表，其他表用user_id代表用戶id * parent_id代表父級ID * 多語言排序要求字符串類型，統一utf8mb4_unicode_ci ## 內容保存規范 * thinkcmf所有字段內容都是`htmlspecialchars`方法處理過的 ## 富文本字段保存規范 * 富文本字段里在保存時要用`htmlspecialchars_decode`解密后用`cmf_replace_content_file_url`處理后，再`htmlspecialchars`方法處理后再保存到數據庫 > 注意`cmf_replace_content_file_url`第二個參數要設置為`true` ## 富文本字段顯示規范 * 富文本字段里在從數據庫取出時要用`htmlspecialchars_decode`解密后用`cmf_replace_content_file_url`處理 ## 文件路徑保存規范 * 所有上傳的文件在數據庫的保存格式都應該是相對路徑，相對于 `upload` 目錄，如`/upload/20170912/b249b3a5bd5ab59f726afb5c73eae699.jpg`在數據庫中應該為`20170912/b249b3a5bd5ab59f726afb5c73eae699.jpg`, 在從數據庫取出后可以用`cmf_get_image_url`函數和`cmf_get_file_download_url`函數轉化為可以訪問的 url 和可以下載的 url；