> 純后臺使用的模型統一放在`/application/admin/model`目錄下,多個模塊公用的模型放在`/application/common/model`目錄下。
## 模型基類
模型基類為`Model`,繼承自`\think\Model`,所有后臺模型都繼承`Model`。
```
//后臺基礎模型
namespace app\admin\model;
use think\db\Query;
class Model extends \think\Model
{
//是否字段,使用場景:用戶的是否凍結,文章是否為熱門等等。
public const BOOLEAN_TEXT = [0 => '否', 1 => '是'];
//是否為軟刪除
public $softDelete = true;
//軟刪除字段默認值
protected $defaultSoftDelete = 0;
//可搜索字段
protected $searchField = [];
//可作為條件的字段
protected $whereField = [];
//禁止刪除的數據id
public $noDeletionId = [];
/**
* 查詢處理
* @var Query $query
* @var array $param
*/
public function scopeWhere($query, $param)
{
//關鍵詞like搜索
$keywords = $param['_keywords'] ?? '';
if (!empty($keywords) && count($this->searchField) > 0) {
$this->searchField = implode('|', $this->searchField);
$query->where($this->searchField, 'like', '%' . $keywords . '%');
}
//字段條件查詢
if (count($this->whereField) > 0 && count($param) > 0) {
foreach ($param as $key => $value) {
if (!empty($value) && in_array($key, $this->whereField)) {
$query->where($key, $value);
}
}
}
//排序
$order = $param['_order'] ?? '';
$by = $param['_by'] ?? 'desc';
$query->order($order ?: 'id', $by ?: 'desc');
}
//狀態獲取器
public function getStatusTextAttr($value, $data)
{
return self::BOOLEAN_TEXT[$data['status']];
}
}
```
## 其他模型
### 后臺用戶模型(AdminUser)
`AdminUser`為后臺用戶模型,包含新增事件和更新事件的密碼處理,查詢當前用戶擁有的權限和顯示的菜單等功能。
### 后臺角色模型(AdminRole)
`AdminRole`為后臺角色模型。
### 后臺菜單/權限模型(AdminMenu)
`AdminMenu`為后臺菜單(權限)模型。
### 后臺用戶模型(AdminLog)
`AdminLog`為后臺操作日志模型。