103 lines
2.6 KiB
Markdown
103 lines
2.6 KiB
Markdown
# 3.3 模型层开发
|
||
|
||
:::tip 概述
|
||
模型层负责定义数据库表的映射关系，继承 BaseModel 后自动获得软删除和审计字段能力。
|
||
:::
|
||
|
||
## 模型文件位置
|
||
|
||
```text
|
||
app/model/Example.php
|
||
```
|
||
|
||
## 完整代码（来自项目实际代码）
|
||
|
||
```php
|
||
<?php
|
||
declare(strict_types=1);
|
||
|
||
namespace app\model;
|
||
|
||
use app\BaseModel;
|
||
|
||
/**
|
||
* 案例演示模型
|
||
*
|
||
* 对应数据表 example，继承 BaseModel 获得通用模型能力
|
||
* （软删除与审计字段自动写入）。
|
||
*
|
||
* 说明：本模型只有表映射，未定义关联或辅助方法；
|
||
* 案例演示的查询过滤、排序、唯一校验等均由 ExampleLogic 配置。
|
||
*/
|
||
class Example extends BaseModel
|
||
{
|
||
/**
|
||
* 数据表名
|
||
*
|
||
* 显式指定表名，覆盖默认的类名推导规则。
|
||
* ThinkPHP 默认使用类名的小写下划线形式作为表名，
|
||
* Example → think_example。如果表名与类名不对应，
|
||
* 可通过 $name 属性显式指定。
|
||
*
|
||
* @var string
|
||
*/
|
||
protected $name = 'example';
|
||
}
|
||
```
|
||
|
||
## 继承 BaseModel 后获得的能力
|
||
|
||
| 能力 | 说明 | 代码示例 |
|
||
|------|------|----------|
|
||
| 软删除 | 全局查询自动过滤 `is_delete=1` | `$list = Example::select();` 自动排除已删除 |
|
||
| 软删除操作 | 设置 `is_delete=1` | `$model->softDelete();` |
|
||
| 批量软删除 | 批量设置 `is_delete=1` | `Example::batchSoftDelete([1,2,3]);` |
|
||
| 审计字段-创建 | 自动填充 `create_user` 和 `create_time` | `Example::create([...])` 时自动填充 |
|
||
| 审计字段-更新 | 自动填充 `update_user` 和 `update_time` | `$model->save([...])` 时自动填充 |
|
||
|
||
## 查询已删除数据
|
||
|
||
```php
|
||
// 查询单条（包括已删除）
|
||
$example = Example::withoutGlobalScope(['soft_delete'])->find($id);
|
||
|
||
// 查询所有（包括已删除）
|
||
$all = Example::withoutGlobalScope(['soft_delete'])->select();
|
||
```
|
||
|
||
## 简单模型 vs 复杂模型
|
||
|
||
:::tip 模型层职责
|
||
模型层只负责表映射和关联关系，不包含业务逻辑。所有查询条件、排序、唯一性校验等都由 Logic 层配置。
|
||
:::
|
||
|
||
### 简单模型（如 Example）
|
||
|
||
只需声明表名，所有逻辑由 Logic 层配置：
|
||
|
||
```php
|
||
class Example extends BaseModel
|
||
{
|
||
protected $name = 'example';
|
||
}
|
||
```
|
||
|
||
### 复杂模型（如 Role）
|
||
|
||
包含关联关系：
|
||
|
||
```php
|
||
class Role extends BaseModel
|
||
{
|
||
protected $name = 'role';
|
||
|
||
/**
|
||
* 关联菜单（多对多）
|
||
* 通过 role_menu 中间表关联
|
||
*/
|
||
public function menus()
|
||
{
|
||
return $this->belongsToMany(Menu::class, 'role_menu', 'menu_id', 'role_id');
|
||
}
|
||
}
|
||
``` |