必须重写模型层行为实现软删除，因为仅改控制器会绕过生命周期钩子、事务及关联逻辑，且其他调用点仍触发物理删除；需覆盖delete()、deleteByPk()、deleteAll()及find()方法，统一处理is_delete字段并默认过滤已删数据。
Yii框架默认的 delete() 是物理删除，直接从数据库删记录。要实现软删除（逻辑删除），必须重写模型层行为，不能只改控制器或路由。
为什么不能只在控制器里改 actionDelete()？
单纯在 FruitController::actionDelete() 里调用 Fruit::updateAll() 看似可行，但会绕过模型的生命周期钩子（如 beforeDelete）、事务控制、关联删除逻辑，且所有手动调用点都要重复写同一套逻辑——极易漏掉或不一致。
更关键的是：后续其他地方（比如后台管理、定时任务、API批量操作）若直接调用 $model->delete()，仍会触发物理删除，软删除形同虚设。
必须重写 ActiveRecord::delete() 和相关方法
核心是让所有“删除动作”统一走逻辑删除路径，包括：
$model->delete()Model::deleteByPk($id)Model::deleteAll($condition)
做法是在基类模型中覆盖这些方法，并检查是否存在 is_delete 字段：
class BaseModel extends \yii\db\ActiveRecord
{
public function delete()
{
if ($this->hasAttribute('is_delete')) {
$this->is_delete = 1;
return $this->save(false, ['is_delete']);
}
return parent::delete();
}
public static function deleteByPk($key)
{
if (static::hasAttribute('is_delete')) {
return static::updateAll(['is_delete' => 1], ['primaryKey' => $key]);
}
return parent::deleteByPk($key);
}
public static function deleteAll($condition = '', $params = [])
{
if (static::hasAttribute('is_delete')) {
return static::updateAll(['is_delete' => 1], $condition, $params);
}
return parent::deleteAll($condition, $params);
}
}
注意：static::hasAttribute('is_delete') 要求字段真实存在于表结构中，且模型已映射该属性（即 public $is_delete; 或通过 attributeLabels() 等间接声明）。
查询时自动过滤已软删除的数据
如果只是删了不显示，还得确保 find() 默认不查 is_delete = 1 的记录，否则前端/接口仍可能拿到“已删”数据。
推荐在基类模型中覆写 find()：
public static function find()
{
$query = parent::find();
if (static::hasAttribute('is_delete')) {
$query->andWhere(['is_delete' => 0]);
}
return $query;
}
这样所有 Fruit::find()->all()、Fruit::findOne(1) 都自动带条件。若某处真需要查全部（含已删），可显式绕过：Fruit::find()->where('1=1')->all()。
RESTful 控制器里不需要再手动处理软删除逻辑
一旦模型基类搞定，FruitController 就可以完全回归标准用法：
- 删单条：保持
DELETE /fruits/123→ActiveController::actionDelete()自动调用$model->delete() - 删多条：用
deleteAll()的场景，也由模型基类统一拦截 - 无需在
actionDelete()里写updateAll()或校验is_delete字段
真正容易被忽略的是：软删除后，count()、sum() 等聚合查询也受 find() 中的默认 where 影响；如果统计“总库存”需包含已删商品，就得用原始查询 —— 这种业务语义差异，必须靠明确的命名方法区分，比如加一个 countWithDeleted()，而不是依赖临时绕过条件。
