第 03 章 一键 CRUD 与代码生成器
3.1 建表规范
一键 CRUD 依赖规范的表结构。以文章表 fa_article 为例:
- snippet.sql
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会被识别为权重字段,列表默认按它倒序
3.2 命令行一键 CRUD
- snippet.bash
php think crud -t article
常用参数:
| 参数 | 说明 |
-t | 表名(不含前缀) |
-c | 控制器名,默认与表名相同 |
-m | 模型名 |
--force | 覆盖已存在文件 |
--delete | 删除已生成的文件 |
3.3 可视化 CRUD
后台「插件管理 → 在线命令 → 一键 CRUD」可通过表单选择数据表、设置字段类型、关联模型,适合不熟悉命令行的场景。
3.4 生成产物解读
以 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 插入菜单节点,需要到「权限管理 → 菜单规则」将节点挂到菜单下并给角色组授权。
3.5 生成后必做的三件事
- 刷新权限:菜单规则中为新控制器生成菜单,分配给角色组
- 清空缓存:
php think clear - 检查列表 JS:
article.js中columns决定表格列、搜索方式与格式化,按需调整
3.6 常见字段类型速查
| 数据库写法 | 生成组件 |
enum('0','1') + 注释 | 单选按钮 / 下拉 |
set('a','b') + 注释 | 复选框 |
字段名含 image/file | 单图/单文件上传 |
字段名含 images/files | 多图/多文件上传 |
字段名 content (text) | 富文本编辑器 |
字段名以 _id 结尾 | 可通过可视化 CRUD 配置关联下拉 |
本章小结
一键 CRUD 是 FastAdmin 效率核心:规范建表 → 一行命令 → 刷新权限即可使用。下一章学习如何深度定制生成的表格与表单。