为了减少大家的重复工作，HisiPHP内置了常用的增、删、改、查、状态变更、排序设置等方法，你无需在创建具体的控制器方法（控制器必须手动创建且必须继承`app\system\admin\Admin`），只需创建对应的模板文件即可。
## 通用添加方法（add）
>[info] 路径生成格式：{:url('模块/控制器/add')}
| 参数 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| hisiModel | string | 调用控制器属性$hisiModel | 模型名称 |
| hisiTable | string | 调用控制器属性$hisiTable | 表名称 |
| hisiValidate | string | 调用控制器属性$hisiValidate | 验证器 |
| hisiScene | string | 调用控制器属性$hisiAddScene | 验证器场景名 |
| template | string | form | 模板名 |
>[info] 以上参数（**template除外**）均支持GET/POST传参，也可在控制里面定义，传参优先。
>[danger] hisiModel、hisiTable、hisiValidate、hisiAddScene 建议在控制器里面定义。
控制器定义示例代码如下：
~~~
<?php
namespace app\test\admin;
use app\system\admin\Admin;
class Article extends Admin
{
protected $hisiModel = '';//模型名称[通用添加、修改专用]
protected $hisiTable = '';//表名称[通用添加、修改专用]
protected $hisiValidate = '';//验证器
protected $hisiAddScene = '';//添加数据验证场景名
protected $hisiEditScene = '';//更新数据验证场景名
public function index()
{
}
}
~~~
## 通用修改方法（edit）
>[info] 路径生成格式：{:url('模块/控制器/edit')}?id=主键ID值
| 参数 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| hisiModel | string | 调用控制器属性$hisiModel | 模型名称 |
| hisiTable | string | 调用控制器属性$hisiTable | 表名称 |
| hisiValidate | string | 调用控制器属性$hisiValidate | 验证器 |
| hisiScene | string | 调用控制器属性$hisiEditScene | 验证器场景名 |
| template | string | form | 模板名 |
>[info] 以上参数（**template除外**）均支持GET/POST传参，也可在控制里面定义（参考上面通用添加方法的示例代码），传参优先。
>[danger] hisiModel、hisiTable、hisiValidate、hisiScene 建议在控制器里面定义。
## 通用删除方法（del）
>[info] 路径生成格式：{:url('模块/控制器/del')}?id=主键ID值
| 参数 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| hisiModel | string | 调用控制器属性$hisiModel | 模型名称 |
| hisiTable | string | 调用控制器属性$hisiTable | 表名称 |
| id | array/int | | 主键值 |
>[info] 以上参数均支持GET/POST传参，也可在控制里面定义（**id除外**，参考上面通用添加方法的示例代码），传参优先。
>[danger] hisiModel、hisiTable 建议在控制器里面定义。
## 通用状态方法（status）
>[info] 路径生成格式：{:url('模块/控制器/status')}?id=主键ID值&val=状态值(0/1)
| 参数 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| hisiModel | string | 调用控制器属性$hisiModel | 模型名称 |
| hisiTable | string | 调用控制器属性$hisiTable | 表名称 |
| id | array/int | | 主键值 |
| field | string | status | 状态字段名 |
| val | int | | 状态值 |
>[info] 以上参数均支持GET/POST传参，也可在控制里面定义（**id、field、val除外**，参考上面通用添加方法的示例代码），传参优先。
>[danger] hisiModel、hisiTable 建议在控制器里面定义。
## 通用排序方法（sort）
>[info] 路径生成格式：{:url('模块/控制器/sort')}?id=主键ID值&val=排序值
| 参数 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| hisiModel | string | 调用控制器属性$hisiModel | 模型名称 |
| hisiTable | string | 调用控制器属性$hisiTable | 表名称 |
| id | array/int | | 主键值 |
| field | string | sort | 排序字段名 |
| val | int | | 排序值 |
>[info] 以上参数均支持GET/POST传参，也可在控制里面定义（**id、field、val除外**，参考上面通用添加方法的示例代码），传参优先。
>[danger] hisiModel、hisiTable 建议在控制器里面定义。
## 通用上传方法（upload）
>[info] 路径生成格式：{:url('模块/控制器/upload')}
| 参数 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| from | string | layui | 上传控件名（可选值：kindeditor，umeditor，ckeditor，ueditor，layui） |
| group | string | sys | 上传资源分组名 |
| water | string | | 水印，默认调用系统配置，no直接关闭水印，image 图片水印，text文字水印 |
| thumb | string | | 缩略图尺寸格式，默认调用系统配置，no直接关闭缩略图，如需生成 500x500 的缩略图，则 500x500多个规格请用";"隔开 |
| thumb\_type | string | | 缩略图方式 |
| input | string | file | 文件表单字段名 |
| full\_path | string | false | 是否返回完整的文件路径(含域名)本地上传有效 |
>[info] 以上参数均支持GET/POST传参。
- 序言
- 环境配置
- 下载及安装
- 目录结构
- 系统配置
- 多语言
- 命令行（pro版）
- 自动生成模块或插件（build）
- 生成模块
- 生成插件
- 自动生成增删改查（crud）
- 第一步：创建数据表
- 第二步：使用crud指令生成
- 自动生成类库文件（make）
- 生成控制器文件（make:controller）
- 生成模型文件（make:model）
- 生成逻辑文件（make:logic）
- 生成服务文件（make:service）
- 生成验证器文件（make:validate）
- 构建器（pro版）
- 表单构建器（form）
- 表单属性设置
- 添加表单项
- 文本框（text）
- 隐藏域（hidden）
- 密码框（password）
- 文本域（textarea）
- 单文件（file）
- 多文件（files）
- 单图（image）
- 多图（images）
- 开关（switch）
- 单选（radio）
- 多选（checkbox）
- 下拉框（select）
- 标签（tag）
- 日期时间（datetime）
- 颜色选择器（color）
- 富文本编辑器（editor）
- 滑块（slider）
- 评分（rate）
- 穿梭框（transfer）
- 进度条（progress）
- 树形（tree）
- 联动（linkage）
- 自定义html（html）
- 分隔线（line）
- 文字（txt）
- 下拉框增强版（select+）
- 数据表格（table）
- 添加表单分组（group）
- 栅格布局（grid）
- 触发器（trigger）
- 通用上传方法
- 表格构建器（table）
- 表格基础配置
- 添加表头工具栏
- 添加表格筛选
- 页面提示（pageTips）
- 引入 JS 文件
- 引入 CSS 文件
- 渲染额外 JS 代码
- 渲染额外 CSS 代码
- 模块开发
- 1.生成模块
- 2.创建菜单
- 3.创建控制器
- 后台通用方法
- 插件开发
- 1.新建插件
- 2.插件配置
- 3.插件控制器
- 4.插件模板
- 5.插件钩子
- 模板替换变量
- 公共函数库
- 后台通用JS方法
- 常见问题
- 官方模块
- CMS内容管理模块
- 目录结构
- 模板标签
- API接口
- 栏目页/内容页
- 小程序发布
- 官方插件
- 第三方登录
- excel插件
- 万能采集
- 采集规则
- 采集内容