[TOC]
> 所有的控制器都在`/application/admin/controller`目录下，不再赘述。
## 基础控制器
### 介绍
- 基础控制器为`Controller`，继承`\think\Controller`，定义了以下变量：`$url`，`$uid`，`$user，`$admin`，`$authExcept`，具体释义可见代码注释。
- 基础控制器包含`initialize()`，`fetch()`，`_empty()`方法，都为TP自带方法，内容可自行阅读代码。
- 基础控制器引用了三个`trait`，分别为`AdminAuth`，`AdminTree`，`PhpOffice`，分别对应后台权限相关验证、树结构生成，Excel导出(目前)相关功能。
### 流程
1. 验证权限
2. 记录访问日志
3. 分页配置赋值
4. 执行具体控制器方法
5. `fetch`或 `admin_success`,`admin_error`返回结果
## 具体业务控制器
### 主要方法
> 以下方法均可使用代码生成器一键生成，无需手动写代码。
#### index
`index`方法为列表页方法，包含搜索、查询、导出功能，如下：
```php
//列表
public function index(Request $request, User $model)
{
$param = $request->param();
$model = $model->scope('where', $param)
->order($param['_order'] ?? 'id', $param['_by'] ?? 'desc');
if (isset($param['export_data']) && $param['export_data'] == 1) {
$header = ['ID', '用户名', '密码', '昵称', '头像', '是否启用', '创建时间',];
$body = [];
$data = $model->select();
foreach ($data as $item) {
$record = [];
$record['id'] = $item->id;
$record['username'] = $item->username;
$record['password'] = $item->password;
$record['nickname'] = $item->nickname;
$record['avatar'] = $item->avatar;
$record['status'] = $item->status_text;
$record['create_time'] = $item->create_time;
$body[] = $record;
}
return $this->exportData($header, $body, 'user-' . date('Y-m-d-H-i-s'));
}
$data = $model->paginate($this->admin['per_page'], false, ['query' => $request->get()]);
//关键词，排序等赋值
$this->assign($request->get());
$this->assign([
'data' => $data,
'page' => $data->render(),
'total' => $data->total(),
]);
return $this->fetch();
}
```
#### add
`add`为添加数据方法，包含添加数据视图的显示，添加数据的验证，保存功能，代码如下：
```php
//添加
public function add(Request $request, User $model, UserValidate $validate)
{
if ($request->isPost()) {
$param = $request->param();
$validate_result = $validate->scene('add')->check($param);
if (!$validate_result) {
return admin_error($validate->getError());
}
//处理头像上传
$attachment_avatar = new \app\common\model\Attachment;
$file_avatar = $attachment_avatar->upload('avatar');
if ($file_avatar) {
$param['avatar'] = $file_avatar->url;
} else {
return admin_error($attachment_avatar->getError());
}
$result = $model::create($param);
$url = URL_BACK;
if (isset($param['_create']) && $param['_create'] == 1) {
$url = URL_RELOAD;
}
return $result ? admin_success('添加成功', $url) : admin_error();
}
return $this->fetch();
}
```
#### eidt
`edit`为更新方法，包含更新数据视图的显示，更新数据的验证，保存功能，代码如下：
```
//修改
public function edit($id, Request $request, User $model, UserValidate $validate)
{
$data = $model::get($id);
if ($request->isPost()) {
$param = $request->param();
$validate_result = $validate->scene('edit')->check($param);
if (!$validate_result) {
return admin_error($validate->getError());
}
//处理头像上传
if (!empty($_FILES['avatar']['name'])) {
$attachment_avatar = new \app\common\model\Attachment;
$file_avatar = $attachment_avatar->upload('avatar');
if ($file_avatar) {
$param['avatar'] = $file_avatar->url;
}
}
$result = $data->save($param);
return $result ? admin_success() : admin_error();
}
$this->assign([
'data' => $data,
]);
return $this->fetch('add');
}
```
#### del
`del`方法为删除方法，包含删除数据的判断，批量删除，然删除等，示例代码如下：
```
//删除
public function del($id, User $model)
{
if (count($model->noDeletionId) > 0) {
if (is_array($id)) {
if (array_intersect($model->noDeletionId, $id)) {
return admin_error('ID为' . implode(',', $model->noDeletionId) . '的数据无法删除');
}
} else if (in_array($id, $model->noDeletionId)) {
return admin_error('ID为' . $id . '的数据无法删除');
}
}
if ($model->softDelete) {
$result = $model->whereIn('id', $id)->useSoftDelete('delete_time', time())->delete();
} else {
$result = $model->whereIn('id', $id)->delete();
}
return $result ? admin_success('操作成功', URL_RELOAD) : admin_error();
}
```
#### enable
`enable`方法为启用方法，可进行单个数据或批量数据的启用，示例代码如下：
```
//启用
public function enable($id, User $model)
{
$result = $model->whereIn('id', $id)->update(['status' => 1]);
return $result ? admin_success('操作成功', URL_RELOAD) : admin_error();
}
```
#### disable
`disable`方法为禁用方法，可进行单个数据或批量数据的禁用，示例代码如下：
```
//禁用
public function disable($id, User $model)
{
$result = $model->whereIn('id', $id)->update(['status' => 0]);
return $result ? admin_success('操作成功', URL_RELOAD) : admin_error();
}
```
