一键 CRUD 依赖规范的表结构。以文章表 fa_article 为例:
CREATE TABLE `fa_article` ( `id` INT UNSIGNED NOT NULL AUTO_INCREMENT, `category_id` INT NOT NULL DEFAULT '0' COMMENT '分类ID', `title` VARCHAR(100) NOT NULL DEFAULT '' COMMENT '标题', `image` VARCHAR(255) NOT NULL DEFAULT '' COMMENT '封面图', `content` text COMMENT '内容', `views` INT NOT NULL DEFAULT '0' COMMENT '浏览量', `status` enum('0','1') NOT NULL DEFAULT '1' COMMENT '状态:0=隐藏,1=显示', `weigh` INT NOT NULL DEFAULT '0' COMMENT '权重', `createtime` INT DEFAULT NULL COMMENT '创建时间', `updatetime` INT DEFAULT NULL COMMENT '更新时间', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章表';
要点:
status 使用 enum + 注释:key=value 格式可自动生成单选/下拉createtime/updatetime 会被识别为时间字段并自动维护weigh 会被识别为权重字段,列表默认按它倒序php think crud -t article
常用参数:
| 参数 | 说明 |
-t | 表名(不含前缀) |
-c | 控制器名,默认与表名相同 |
-m | 模型名 |
--force | 覆盖已存在文件 |
--delete | 删除已生成的文件 |
后台「插件管理 → 在线命令 → 一键 CRUD」可通过表单选择数据表、设置字段类型、关联模型,适合不熟悉命令行的场景。
以 article 为例会生成:
application/admin/controller/Article.php # 控制器 application/admin/model/Article.php # 模型 application/admin/validate/Article.php # 验证器 application/admin/view/article/index.html # 列表视图 application/admin/view/article/add.html # 添加视图 application/admin/view/article/edit.html # 编辑视图 public/assets/js/backend/article.js # 列表 JS(表格配置) application/admin/lang/zh-cn/article.php # 语言包
同时在 fa_auth_rule 插入菜单节点,需要到「权限管理 → 菜单规则」将节点挂到菜单下并给角色组授权。
php think cleararticle.js 中 columns 决定表格列、搜索方式与格式化,按需调整| 数据库写法 | 生成组件 |
enum('0','1') + 注释 | 单选按钮 / 下拉 |
set('a','b') + 注释 | 复选框 |
字段名含 image/file | 单图/单文件上传 |
字段名含 images/files | 多图/多文件上传 |
字段名 content (text) | 富文本编辑器 |
字段名以 _id 结尾 | 可通过可视化 CRUD 配置关联下拉 |
一键 CRUD 是 FastAdmin 效率核心:规范建表 → 一行命令 → 刷新权限即可使用。下一章学习如何深度定制生成的表格与表单。