ThinkPHP怎么处理模型关联删除_ThinkPHP级联删除数据策略【说明】-ThinkPHP-PHP中文网

thinkphp 的 delete() 默认不触发关联删除，需用 withdelete() 显式声明并配合 ondelete('cascade') 定义及事务包裹，否则易致数据不一致。

thinkphp怎么处理模型关联删除_thinkphp级联删除数据策略【说明】

ThinkPHP 的 `delete()` 方法默认不触发关联删除

调用模型实例的 delete() 或静态方法 destroy() 时，ThinkPHP 只删当前模型对应的数据表记录，不会自动删掉它关联的子表（比如一对多中的评论、订单项）。这不是 bug，是框架的默认安全策略——防止误删。

常见错误现象：User::find(123)->delete() 执行后，用户没了，但它的 user_posts 还在；或者你写了 hasMany 关系却没看到子记录消失。

必须显式启用级联行为，靠关系定义里的 autoWrite 或删除时传参控制
destroy() 静态批量删除默认完全不走关联逻辑，哪怕模型里定义了 onDelete
软删除（softDelete）开启后，级联也只软删，不会物理清除子记录

用 `withDelete` 显式声明要删哪些关联

这是最可控、最推荐的方式：在删除主模型时，手动指定要连带处理的关联关系。它不依赖模型定义里的钩子，也不影响其他地方的 delete 行为。

使用场景：仅在某次业务操作中需要彻底清理（如管理员删除用户并清空其全部订单+地址），且不想全局改变模型行为。

示例：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

$user = User::with(['orders', 'addresses'])->find(123);
$user->withDelete(['orders', 'addresses'])->delete();

withDelete() 接收数组，元素是关系方法名（不是表名），必须和 with() 中一致
关联方法需已定义 onDelete 行为，比如 orders() 里返回 $this->hasMany(Order::class)->onDelete('cascade')
如果某个关联未定义 onDelete，withDelete 会跳过它，不报错也不提醒

`onDelete('cascade')` 要写在关联定义里，不是数据库外键上

ThinkPHP 的级联删除是 ORM 层模拟的，和 MySQL 的 FOREIGN KEY ... ON DELETE CASCADE 无关。即使数据库没建外键，只要 PHP 层定义了 onDelete('cascade')，withDelete 就能触发子模型的 delete()。

参数差异：onDelete() 支持三个值：'cascade'（调用子模型 delete()）、'null'（设外键字段为 NULL）、'restrict'（阻止删除主记录）。