目录

第 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='文章表';

要点:

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 生成后必做的三件事

  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 效率核心:规范建表 → 一行命令 → 刷新权限即可使用。下一章学习如何深度定制生成的表格与表单。