数据库

这里提供的是数据库表字段规则在你创建表时使用,当按如下的规则进行字段命名、类型设置和备注时
使用php think crud -t 表名生成CRUD时会自动生成对应的控制器、模型、视图、JS等。

根据字段类型

类型备注类型说明
int整型自动生成type为number的文本框,步长为1
enum枚举型自动生成单选下拉列表框
setset型自动生成多选下拉列表框
float浮点型自动生成type为number的文本框,步长根据小数点位数生成
text文本型自动生成textarea文本框
datetime日期时间自动生成日期时间的组件
date日期型自动生成日期型的组件
timestamp时间戳自动生成日期时间的组件
varchar字符串当字符串长度定义大于等于255时,将自动在列表启用autocontent,仅支持FastAdmin1.4.0+

特殊字段

字段字段名称字段类型字段说明
user_id会员IDint将生成选择会员的SelectPage组件,单选
user_ids会员ID集合varchar将生成选择会员的SelectPage组件,多选
admin_id管理员IDint将生成选择管理员的SelectPage组件
admin_ids管理员ID集合varchar将生成选择管理员的SelectPage组件,多选
category_id分类IDint将生成选择分类的下拉框,分类类型根据去掉前缀的表名,单选
category_ids分类ID集合varchar将生成选择分类的下拉框,分类类型根据去掉前缀的表名,多选
weigh权重int后台的排序字段,如果存在该字段将出现排序按钮,可上下拖动进行排序
createtime创建时间bigint/datetime记录添加时间字段,不需要手动维护
updatetime更新时间bigint/datetime记录更新时间的字段,不需要手动维护
deletetime删除时间bigint/datetime记录删除时间的字段,不需要手动维护,如果存在此字段将会生成回收站功能,字段默认值务必为null
status状态字段enum列表筛选字段,如果存在此字段将启用TAB选项卡展示列表

以特殊字符结尾的规则

结尾字符示例类型要求字段说明
timerefreshtimebigint/datetime识别为日期时间型数据,自动创建选择时间的组件
imagesmallimagevarchar识别为图片文件,自动生成可上传图片的组件,单图
imagessmallimagesvarchar识别为图片文件,自动生成可上传图片的组件,多图
fileattachfilevarchar识别为普通文件,自动生成可上传文件的组件,单文件
filesattachfilesvarchar识别为普通文件,自动生成可上传文件的组件,多文件
avatarminiavatarvarchar识别为头像,自动生成可上传图片的组件,单图
avatarsminiavatarsvarchar识别为头像,自动生成可上传图片的组件,多图
contentmaincontenttext/mediumtext/longtext识别为内容,自动生成富文本编辑器(需安装富文本插件)
_iduser_idint/varchar识别为关联字段,自动生成可自动完成的文本框,单选
_idsuser_idsvarchar识别为关联字段,自动生成可自动完成的文本框,多选
listtimelistenum识别为列表字段,自动生成单选下拉列表
listtimelistset识别为列表字段,自动生成多选下拉列表
datahobbydataenum识别为选项字段,自动生成单选框
datahobbydataset识别为选项字段,自动生成复选框
jsonconfigjsonvarchar识别为键值组件,自动生成键值录入组件,仅支持1.2.0+
switchsiteswitchtinyint识别为开关字段,自动生成开关组件,默认值10,仅支持FastAdmin 1.2.0+
rangedaterangevarchar识别为时间区间组件,自动生成时间区间组件,仅支持FastAdmin 1.3.0+
tagarticletagvarchar识别为Tagsinput,自动生成标签输入组件,仅支持FastAdmin 1.3.0+
tagsarticletagsvarchar识别为Tagsinput,自动生成标签输入组件,仅支持FastAdmin 1.3.0+
温馨提示:以list或data结尾的字段必须搭配enum或set类型才起作用
如果为多图或多列表字段,请务必确保字段长度足够

注释说明

字段注释内容字段类型字段说明
status状态int将生成普通语言包和普通文本框
status状态enum(‘0’,’1’,’2’)将生成普通语言包和单选下拉列表,同时生成TAB选项卡
status状态:0=隐藏,1=正常,2=推荐enum(‘0’,’1’,’2’)将生成多个语言包和单选下拉列表,同时生成TAB选项卡,且列表中的值显示为对应的文字##

常见问题

  1. 如果使用php think crud生成过表的CRUD,当修改了表结构类型或新增了字段,此时只有重新生成CRUD或自己手动修改视图文件和JS文件。
  2. 如果你的表需要生成关联模型,建议你在设计表时遵循以下规范,category_id字段关联对应fa_category表主键,company_info_id关联对应fa_company_info表主键。
  3. 如果字段名为user_id,生成的动态下拉列表会自动匹配user/index这个控制器方法,如果你发现CRUD后无法显示关联数据列表,请检查视图中元素data-source的值是否正确。
  4. 当设定数据库字段不能为NULL时,表单会自动追加必选required验证。
文档最后更新时间:2023-12-14 21:21:53
著作权归应用插件开发者所有,未经许可,禁止转载、复制此文档的任何内容。