# 第 03 章 一键 CRUD 与代码生成器 ## 3.1 建表规范 一键 CRUD 依赖规范的表结构。以文章表 `fa_article` 为例: ```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 ```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 生成后必做的三件事 1. **刷新权限**:菜单规则中为新控制器生成菜单,分配给角色组 2. **清空缓存**:`php think clear` 3. **检查列表 JS**:`article.js` 中 `columns` 决定表格列、搜索方式与格式化,按需调整 ## 3.6 常见字段类型速查 | 数据库写法 | 生成组件 | | `enum('0','1')` + 注释 | 单选按钮 / 下拉 | | `set('a','b')` + 注释 | 复选框 | | 字段名含 `image`/`file` | 单图/单文件上传 | | 字段名含 `images`/`files` | 多图/多文件上传 | | 字段名 `content` (text) | 富文本编辑器 | | 字段名以 `_id` 结尾 | 可通过可视化 CRUD 配置关联下拉 | ## 本章小结 一键 CRUD 是 FastAdmin 效率核心:规范建表 → 一行命令 → 刷新权限即可使用。下一章学习如何深度定制生成的表格与表单。