靳宇灵 | FastAdmin数据库开发规则-CFANZ编程社区

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

根据字段类型

类型	备注	类型说明
int	整型	自动生成type为number的文本框，步长为1
enum	枚举型	自动生成单选下拉列表框
set	set型	自动生成多选下拉列表框
float	浮点型	自动生成type为number的文本框，步长根据小数点位数生成
text	文本型	自动生成textarea文本框
datetime	日期时间	自动生成日期时间的组件
date	日期型	自动生成日期型的组件
timestamp	时间戳	自动生成日期时间的组件

特殊字段

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

以特殊字符结尾的规则

结尾字符	示例	类型要求	字段说明
time	refreshtime	bigint/datetime	识别为日期时间型数据，自动创建选择时间的组件
image	smallimage	varchar	识别为图片文件，自动生成可上传图片的组件，单图
images	smallimages	varchar	识别为图片文件，自动生成可上传图片的组件，多图
file	attachfile	varchar	识别为普通文件，自动生成可上传文件的组件，单文件
files	attachfiles	varchar	识别为普通文件，自动生成可上传文件的组件，多文件
avatar	miniavatar	varchar	识别为头像，自动生成可上传图片的组件，单图
avatars	miniavatars	varchar	识别为头像，自动生成可上传图片的组件，多图
content	maincontent	text/mediumtext/longtext	识别为内容，自动生成富文本编辑器(需安装富文本插件)
_id	user_id	int/varchar	识别为关联字段，自动生成可自动完成的文本框，单选
_ids	user_ids	varchar	识别为关联字段，自动生成可自动完成的文本框，多选
list	timelist	enum	识别为列表字段，自动生成单选下拉列表
list	timelist	set	识别为列表字段，自动生成多选下拉列表
data	hobbydata	enum	识别为选项字段，自动生成单选框
data	hobbydata	set	识别为选项字段，自动生成复选框
json	configjson	varchar	识别为键值组件，自动生成键值录入组件，仅支持1.2.0+
switch	siteswitch	tinyint	识别为开关字段，自动生成开关组件，默认值`1`为`开`，`0`为`关`，仅支持1.2.0+
range	daterange	varchar	识别为时间区间组件，自动生成时间区间组件，仅支持1.3.0+
tag	articletag	varchar	识别为Tagsinput，自动生成标签输入组件，仅支持1.3.0+
tags	articletags	varchar	识别为Tagsinput，自动生成标签输入组件，仅支持1.3.0+

温馨提示：以list或data结尾的字段必须搭配enum或set类型才起作用
如果为多图或多列表字段，请务必确保字段长度足够

注释说明

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

常见问题

如果使用php think crud生成过表的CRUD，当修改了表结构类型或新增了字段，此时只有重新生成CRUD或自己手动修改视图文件和JS文件。
如果你的表需要生成关联模型，建议你在设计表时遵循以下规范，category_id字段关联对应fa_category表主键，company_info_id关联对应fa_company_info表主键。
如果字段名为user_id，生成的动态下拉列表会自动匹配user/index这个控制器方法，如果你发现CRUD后无法显示关联数据列表，请检查视图中元素data-source的值是否正确。