[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();
}
```
