[TOC]
> 所有的控制器都在`/app/admin/controller`目錄下，不再贅述。
## 基礎控制器
### 介紹
- 基礎控制器為`AdminBaseController`，方法及變量都有完整的注釋，可自行查看。
- 基礎控制器引用了三個`trait`，分別為`AdminAuthTrait`，`AdminTreeTrait`，`AdminPhpOffice`，分別對應后臺權限相關驗證、樹結構生成，Excel導出(目前)相關功能，方法解析可參看下一節。
### 流程
1. 檢查登錄
1. 檢查權限
3. 單設備登錄檢查
2. csrfToken檢查
2. 初始化view
1. 分頁配置賦值
1. 記錄訪問日志
1. 執行具體控制器方法
1. 拋出`HttpResponseException`異常或使用`fetch`，`admin_success`，`admin_error`返回結果
## 具體業務控制器
### 主要方法
> 以下方法均可使用代碼生成器一鍵生成，無需手動寫代碼。
#### index（列表方法）
`index`方法為列表頁方法，包含搜索、查詢、導出功能，如下：
```php
/**
* 列表
* @param Request $request
* @param User $model
* @return string
* @throws Exception
*/
public function index(Request $request, User $model): string
{
$param = $request->param();
$data = $model->with('user_level')->scope('where', $param)
->paginate([
'list_rows' => $this->admin['admin_list_rows'],
'var_page' => 'page',
'query' => $request->get(),
]);
// 關鍵詞，排序等賦值
$this->assign($request->get());
$this->assign([
'data' => $data,
'page' => $data->render(),
'total' => $data->total(),
'user_level_list' => UserLevel::select(),
'status_list' => User::STATUS_LIST,
]);
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();
}
```
