模型的删除和数据库的删除方法区别在于,模型的删除会包含模型的事件处理。
## 删除当前模型
删除模型数据,可以在查询后调用`delete`方法。
~~~
$user = User::find(1);
$user->delete();
~~~
> `delete`方法返回布尔值
## 根据主键删除
或者直接调用静态方法(根据主键删除)
~~~
User::destroy(1);
// 支持批量删除多个数据
User::destroy([1,2,3]);
~~~
>[danger] 当`destroy`方法传入空值(包括空字符串和空数组)的时候不会做任何的数据删除操作,但传入0则是有效的
## 条件删除
还支持使用闭包删除,例如:
~~~
User::destroy(function($query){
$query->where('id','>',10);
});
~~~
或者通过数据库类的查询条件删除
~~~
User::where('id','>',10)->delete();
~~~
>[danger] 直接调用数据库的`delete`方法的话无法调用模型事件。
## 软删除
在实际项目中,对数据频繁使用删除操作会导致性能问题,软删除的作用就是把数据加上删除标记,而不是真正的删除,同时也便于需要的时候进行数据的恢复。
要使用软删除功能,需要引入`SoftDelete` trait,例如`User`模型按照下面的定义就可以使用软删除功能:
~~~
<?php
namespace app\model;
use think\Model;
use think\model\concern\SoftDelete;
class User extends Model
{
use SoftDelete;
protected $deleteTime = 'delete_time';
}
~~~
`deleteTime`属性用于定义你的软删除标记字段,`ThinkORM`的软删除字段使用时间类型,用于记录数据的删除时间。可以使用`defaultSoftDelete`属性来定义软删除字段的默认值,没有设置的话默认值为`Null`。
~~~
<?php
namespace app\model;
use think\Model;
use think\model\concern\SoftDelete;
class User extends Model
{
use SoftDelete;
protected $deleteTime = 'delete_time';
protected $defaultSoftDelete = 0;
}
~~~
> 可以用类型转换指定软删除字段的类型,建议数据表的所有时间字段统一一种类型。
定义好模型后,我们就可以使用:
~~~
// 软删除
User::destroy(1);
// 真实删除
User::destroy(1,true);
$user = User::find(1);
// 软删除
$user->delete();
// 真实删除
$user->force()->delete();
~~~
默认情况下查询的数据不包含软删除数据,如果需要包含软删除的数据,可以使用下面的方式查询:
~~~
User::withTrashed()->find();
User::withTrashed()->select();
~~~
如果仅仅需要查询软删除的数据,可以使用:
~~~
User::onlyTrashed()->find();
User::onlyTrashed()->select();
~~~
恢复被软删除的数据
~~~php
$user = User::onlyTrashed()->find(1);
$user->restore();
~~~
>[danger] 软删除的删除操作仅对模型的删除方法有效,如果直接使用数据库的删除方法则无效,例如下面的方式无效。
~~~
$user = new User;
$user->where('id',1)->delete();
~~~
## 最佳实践
>[info] 删除的最佳实践原则是:如果删除当前模型数据,用`delete`方法,如果需要直接删除数据,使用`destroy`静态方法。
- 简介
- 数据库配置
- 分布式数据库
- 查询构造器
- 查询数据
- 新增数据
- 更新数据
- 删除数据
- 链式操作
- Where
- Table
- Alias
- Field
- Strict
- Limit
- Page
- Order
- Group
- Having
- Join
- Union
- Distinct
- Lock
- Cache
- Comment
- FetchSql
- Force
- Partition
- Replace
- FailException
- Extra
- Duplicate
- Sequence
- Procedure
- View
- 聚合查询
- 分页查询
- 时间查询
- 高级查询
- 子查询
- 原生查询
- 事务操作
- 存储过程
- 查询事件
- JSON字段
- 模型
- 定义
- 新增
- 更新
- 删除
- 查询
- 查询范围
- 只读字段
- JSON字段
- 自动时间写入
- 获取器
- 修改器
- 搜索器
- 类型转换
- 模型输出
- 模型事件
- 虚拟模型
- 关联
- 一对一关联
- 一对多关联
- 远程一对多
- 远程一对一
- 多对多关联
- 多态一对多
- 多态一对一
- 关联预载入
- 关联统计
- 关联输出
- SQL监听
- 缓存机制
- 字段缓存
- 查询缓存
- 扩展
- 自定义查询类
- 自定义数据库驱动