>[danger]注意在模板页面不要添加queryParams:function参数，此参数在框架中扩展了，添加后会请求两次，导致你的搜索条件被重置 ## **新建数据库数据表** 模型管理新建模型-【表名称】就是数据库自动生成的数据表，然后在【字段管理】添加该表的字段 >[danger]选择`CMS`：主键、create\_time、update\_time、\[sort 勾选排序字段时\]、\[status 勾选状态字段时\]、\[cate\_id, hits, keywords, description, template, url \] 选择`后台`：主键、create\_time、update\_time、\[sort 勾选排序字段时\]、\[status 勾选状态字段时\] >注意添加字段名时小心的去掉**前后空格**，此cms提交时没有trim过滤，否则在增改时对该字段失效,如果不小心发现空格那么请对此表和field表的模型id对应的字段进行修改 以下模块为系统内置模块，无法生成代码和菜单规则，如需修改请直接修改代码 ~~~ 'Admin', 'AdminLog', 'AuthGroup', 'AuthRule', 'Module', 'Field', 'Cate' ~~~ 以下为保留名称新建模块时不可做为表名称使用(已有控制器) ~~~ 'config', 'database', 'demo', 'index', 'login', 'plugin', 'template','upload' ~~~ **特殊字段说明** | 字段 | 字段名称 | 字段类型 | 必须存在 | 字段说明 | | --- | --- | --- | --- | --- | | id | 主键 | int / mediumint 等 | 是 | 主键可以为其他 | | create\_time | 创建时间 | int | 是 | 自动时间戳 | | update\_time | 更新时间 | int | 是 | 自动时间戳 | | sort | 排序（权重） | int / mediumint 等 | 否 | 建议设置默认值为`50` | | status | 状态 | tinyint / int / mediumint 等 | 否 | 值只能为`1`或`0`（显示/隐藏） | | \- | \- | \- | \- | \- | | cate\_id | 栏目ID | tinyint / int / mediumint 等 | 是（表类型为`CMS`时） | 栏目ID | | hits | 点击次数 | int / mediumint 等 | 是（表类型为`CMS`时） | 浏览/点击次数 | | keywords | 关键词 | varchar / char / text / mediumtext | 是（表类型为`CMS`时） | SEO关键词 | | description | 描述 | varchar / char / text / mediumtext | 是（表类型为`CMS`时） | SEO描述 | | template | 模板 | varchar / char / text / mediumtext | 是（表类型为`CMS`时） | 自定义模板 | | url | 跳转地址 | varchar / char / text / mediumtext | 是（表类型为`CMS`时） | 自定义跳转地址 | **以特殊字符结尾的规则** | 结尾字符 | 示例 | 类型要求 | 字段说明 | | --- | --- | --- | --- | | time | pay\_time | int | 识别为日期时间 | | image | user\_image | varchar / char / text / mediumtext | 识别为单图片上传 | | images | user\_images | varchar / char / text / mediumtext | 识别为多图片上传 | | file | product\_file | varchar / char / text / mediumtext | 识别为单文件上传 | | files | product\_files | varchar / char / text / mediumtext | 识别为多文件上传 | | avatar | user\_image | varchar / char / text / mediumtext | 识别为单图片上传 | | avatars | user\_images | varchar / char / text / mediumtext | 识别为多图片上传 | | content | news\_content | varchar / char / text / mediumtext | 识别为编辑器 | | password | user\_password | varchar / char | 识别为密码 | ### **模型关联** 模型关联时数据源必须选择模型数据，关联模型就是要关联的主表，展示字段就是显示关联表的那个字段 **例如：** 从表contract中存在tender_id、party_company、salesman_id 关联主表Tender 在contract模型中编辑tender_id字段设置如下：    在**主表**（不包含外键）的模型中建立关联关系，用**hasOne** 在**从表**（包含外键）模型中建立关联关系，用**belongsTo** ``` namespace app\common\model; class Contract extends Base { // 定义时间戳字段名 protected $createTime = 'create_time'; protected $updateTime = 'update_time'; public function salesman() { return $this->belongsTo('Salesman', 'salesman_id'); } //hasOne('关联从表模型名','从表外键名','主表主键名',\['模型别名定义'\],'join类型，默认`INNER`'); //belongsTo('关联主表模型名','从表外键名','关联表主表键名',\['模型别名定义'\],'join类型'); public function partyCompany() { return $this->belongsTo('PartyCompany', 'party_company'); } public function tender() { return $this->belongsTo('Tender', 'tender_id'); } } ``` TableBuilder::fetch() 和FormBuilder::fetch() 只负责分配变量和渲染模板，他们的其他方法几乎都是组装$this->_vars(即要分配的变量) ~~~ View::assign($this->_vars); return View::fetch($this->_template); ~~~ 表格的数据都是通过ajax获取的,表格ajax请求的地址【列表页?getList=1】，于是我们在index的方法里获取getList参数且值=1我们就通过继承Base的模型::getList查询相应的数据(默认返回数据集)然后传入MakeBuilder::changeTableData()将数据集转成数组，然后格式化成想要的数据后返回此数组(php数组格式bootstraptable能识别？) 此cms列表页index方法默认在Base.php中， ``` // 列表 public function index() { // 获取主键 $pk = MakeBuilder::getPrimarykey($this->tableName); // 获取列表数据 $columns = MakeBuilder::getListColumns($this->tableName); // 获取搜索数据 $search = MakeBuilder::getListSearch($this->tableName); // 获取当前模块信息 $model = '\app\common\model\\' . $this->modelName; $module = \app\common\model\Module::where('table_name', $this->tableName)->find(); // 搜索 if (Request::param('getList') == 1) { $where = MakeBuilder::getListWhere($this->tableName);//此处默认是没有条件的，只有搜索时才会有对应的条件 //如果我们要在默认时添加别的条件，如默认查询显示1年的信息 $start_time=strtotime(date("Y")."-01-01"); $end_time= strtotime(date("Y-m-d",time())); $extraWhere[]=['inmonth', 'between', [$start_time, $end_time]]; $where=$where+$extraWhere; $orderByColumn = Request::param('orderByColumn') ?? $pk; $isAsc = Request::param('isAsc') ?? 'desc'; return $model::getList($where, $this->pageSize, [$orderByColumn => $isAsc]); } // 检测单页模式 $isSingle = MakeBuilder::checkSingle($this->modelName); if ($isSingle) { return $this->jump($isSingle); } // 获取新增地址 $addUlr = MakeBuilder::getAddUrl($this->tableName); // 构建页面 return TableBuilder::getInstance() ->setUniqueId($pk) // 设置主键 ->addColumns($columns) // 添加列表字段数据 ->setSearch($search) // 添加头部搜索 ->addColumn('right_button', '操作', 'btn') // 启用右侧操作列 ->addRightButtons($module->right_button) // 设置右侧操作列 ->addTopButtons($module->top_button) // 设置顶部按钮组 ->setAddUrl($addUlr) // 设置新增地址 ->fetch(); } } ``` 在index方法if (Request::param('getList') == 1) {}里打印Request::param()参数显示有七个参数["getList",'pageSize','page','orderByColumn','isAsc','title','status']他们都代表什么呢？ **getList：** 表示表格请求的数据列表的参数， **pageSize：** 表格每页显示最多的行数 **page：** 表格当前页 **orderByColumn：** 表示id **isAsc**指示激活排序那列是升序还是降序 **title：** 开启搜索的那个字段(默认管理开启-字段管理-开启搜索，所以搜索不止一个字段) **status** 字段是否是启用状态。(也是字段管理开启显示状态开关，然后点击开关就是变幻的这个状态) 列表页返回数据时需要返回total、per_page、current_page、last_page ``` { "total": 2,//总数居 "per_page": 10,//每页显示多少条 "current_page": 1,//table显示的当前页数 "last_page": 1,//总页数 "data": [ { "id": 2, "create_time": "2021-09-23 13:07:21", "update_time": "2021-09-23 13:07:21", "sort": 50, "status": 1, "title": "啊实打实的" }, { "id": 1, "create_time": "2021-09-18 09:38:07", "update_time": "2021-09-18 09:38:07", "sort": 50, "status": 1, "title": "阿松大", "myname": "aaaaa" } ] } ``` 好啦知道怎么返回数据了吧 ### **系统字典(一般用于select框这种分类)** 字典类型页面新增【字典名称】 字典页面新增字典数据，字典标签就是select的显示的文字，字典键值就是select的value  ## **生成控制器。模型。验证器文件** 勾选要生成文件的模型--然后左键点击【代码生成】则生成三个文件，生成指定的文件则左键点击右边的倒三角符号  >[danger]注意模型文件在app/common/model文件夹下 **生成菜单规则** 列表(index)、新增(add)、新增/添加保存(addPost)、修改(edit)、修改保存(editPost)、删除(del)、批量删除(selectDel)、导出(export)、状态(state)、排序(sort) 等规则