模型介绍

一般后台项目大多数业务处理都是跟模型相关的，所以在模型上做的处理还是比较多的。目前catchadmin的模型都是继承 CatchModel，所以先来看看CatchModel。

INFO

model 一定要慢慢看完，开发加倍效果

CatchModel

abstract class CatchModel extends Model
{
    use BaseOperate, Trans, SoftDeletes, ScopeTrait;

    /**
     * unix timestamp
     *
     * @var string
     */
    protected $dateFormat = 'U';

    /**
     * paginate limit
     */
    protected $perPage = 10;

    /**
     * 关闭自动时间戳
     *
     * @var bool
     */
    public $timestamps = false;

    /**
     * @var string[]
     */
    protected array $defaultCasts = [
        'created_at' => 'datetime:Y-m-d H:i:s',

        'updated_at' => 'datetime:Y-m-d H:i:s',
    ];

    protected array $defaultHidden = ['deleted_at'];

    public function __construct(array $attributes = [])
    {
        parent::__construct($attributes);

        $this->init();
    }

    /**
     * init
     */
    protected function init()
    {
        $this->makeHidden($this->defaultHidden);

        $this->mergeCasts($this->defaultCasts);
    }


    // 修改软删除的查询条件
    public static function bootSoftDeletes(): void
    {
        static::addGlobalScope(new SoftDelete());
    }


    /**
     * 覆盖 restore 方法
     *
     * 修改 deleted_at 默认值
     */
    public function restore(): bool
    {
        if ($this->fireModelEvent('restoring') === false) {
            return false;
        }

        $this->{$this->getDeletedAtColumn()} = 0;

        $this->exists = true;

        $result = $this->save();

        $this->fireModelEvent('restored', false);

        return $result;
    }
}

CatchAdmin 的所有表的 created_at 和 updated_at 都是 timestamp，也就是 int 类型，所以在返回给客户端的时候，需要转成 date，所以单独设置了 defaultCasts

protected array $defaultCasts = [
    'created_at' => 'datetime:Y-m-d H:i:s',

    'updated_at' => 'datetime:Y-m-d H:i:s',
];

这里有人肯定会有疑问？为什么要非要加一个 defaultCasts 属性呢？为什么不直接用 casts？

因为所有模型都是继承CatchAdmin, 并且这个日期转换基本每个模型都会用得到。所以一旦这里如果设置成 casts, 有可能会被用户自定义的 casts 覆盖。还有一个 defualtHidden属性是一个道理

软删除

由于CatchAdmin 软删除默认值是0，所以软删除的查询条件也必须改变。在 CatchModel 引入 SoftDeleteScope，当然使用还是和原本是一样的，无需改动

class SoftDelete extends SoftDeletingScope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->where($model->getQualifiedDeletedAtColumn(), '=', 0);
    }
}

属性

除了上面的改变，CatchAdmin 还新增了若干属性，以增强项目的粘合性。

    // 当需要树状结构的表，父级设置 'parent_id', 建议就使用默认的
    // 因为后台提供的 Tree 结构都是使用该字段
    protected string $parentIdColumn = 'parent_id';

    // 排序字段，默认使用 sort
    protected string $sortField = 'sort';

    // 排序规则
    protected bool $sortDesc = true;

    // 列表的数据返回是否以树状结构返回
    protected bool $asTree = false;

    // 列表查询的默认字段
    protected array $fields = [];

    // 列表是否是分页
    // 默认分页
    protected bool $isPaginate = true;

    // 创建和更新数据提交的字段
    // form 字段
    protected array $form = [];

    // 提交的数据是否有关联关系
    // 例如用户（user） 和 角色 （roles）
    // user 跟角色是一对多的关系
    // 那么 user 模型里面就设置角色关系的方法
    // formRelations 就是使用该方法名称
    protected array $formRelations = [];


     /**
      * 通过属性设置是否启用数据权限

      * @var bool
     */
    protected bool $dataRange = false;


    /**
     * 通过属性设置是否启用数据权限，字段权限功能
     *
     * @var bool
     */
    protected bool $columnAccess = false;

    /**
     * 将 Null 字段自动转换成 string
     *
     * null to empty string
     */
    protected bool $autoNull2EmptyString = true;

    /**
     * 排序字段 query
     *
     * @var string
     */
    protected string $dynamicQuerySortField = 'sortField';

    /**
     * query 排序字段顺序
     *
     * @var string
     */
    protected string $dynamicQuerySortOrder = 'order';

    /**
     * 是否填充创建人
     *
     * 如果不需要则设置为 false
     *
     * @var bool
     */
    protected bool $isFillCreatorId = true;

模型方法

列表

public function getList(): miexed

保存数据

public function storeBy(array $data): bool`

保存数据

public function createBy(array $data): mixed

INFO

该方法可用于循环插入数据，storeBy 则不行

更新数据

public function updateBy($id, array $data): mixed

批量更新

public function batchUpdate(string $field, array $condition, array $data): bool

• field 更新条件的字段 （例如 ID）
• condition 更新条件的值 例如 [1, 2, 3]
• data 更新的数据，已键值对方法 例如 ['name' =>['小明', '小隋', '小书'], 'age' => [12, 12, 13]]

TIP

该方法不支持模型事件

示例

$model = new SomeModel();
$model->batchUpdate('id', [1,2,3],  ['name' =>['小明', '小隋', '小书'], 'age' => [12, 12, 13]])

TIP

更新条件的值的数量要跟 Data 更新的值的数量一致，不然会被忽略

查询数据

public function firstBy($value, $field = null, array $columns = ['*']): ?Model

默认使用 id 字段查询

删除数据

public function deleteBy($id, bool $force = false, bool $softForce = false): ?bool

默认使用 id 字段的 value 删除，force 参数则进行物理删除

删除软删除数据

public function deleteTrash($id): mixed

批量删除

public function deletesBy(array|string $ids, bool $force = false, ?Closure $callback = null): bool

批量删除支持删除软删除数据和正常数据 ids 可以是 数组，也可以是 1,2,3,4,5 这样的字符串

$callback 可以回调处理一些数据, 如下案例

$ids = [1,2,3]
$this->deletesBy(ids, false, (ids) => {
// $ids [1,2,3]
// .... 这里处理删除后的逻辑
})

恢复数据

配合后台的管理的回收站功能使用

public function restoreBy(array|string $ids): true

排序

目前支持设置某个字段进行排序

protected string $sortField = 'sort';

例如在这里设置使用 sort 字段进行倒序排序，默认排序规则 desc。如果要设置正序，设置如下

protected bool $sortDesc = false;

状态切换

public function toggleBy($id, string $field = 'status'): bool

通过 ID 进行状态切换，默认是 status 字段

处理树状数据的下级数据

public function updateChildren(mixed $parentId, string $field, mixed $value): void

字段别名

public function aliasField(string|array $fields): string|array

设置 creator_id

public function setCreatorId()

获取创建人

public function scopeCreator();

这是 scope 查询，可以直接使用。

Model::select('*')->creator()->get();

当然使用该查询，数据表里面必须包含creator_id字段，即创建人字段，否则没有作用

模糊查询

public function whereLike($field, $value)

快速查询

public function quickSearch(array $params = [])

该方法是通过模型属性 searchable 搭配 Request 进行快速搜索，下面一个例子

protected array $searchable = [
    'status' => '=',

    'nickname' => 'like'
]

如果进行这样的设置，模型的查询就会自动动态生成这样的代码, 通过这样的设置就可以很轻松的进行搜索

Model::select('*')
    ->where('status', $request->get('status'))
    ->whereLike('nickname', $request->get('nickname'))
    ->get();

开启事务

之前都需要引入开启事务，例如

DB::beginTransaction();

现在可以直接在模型调用了

$this->beginTransaction();

事务的其他几个操作也是一样的，可以直接在模型中开启