Laravel 模型全局作用域：过滤关联软删除用户的数据-php教程-PHP中文网

Laravel 模型全局作用域：过滤关联软删除用户的数据

本文介绍如何通过 Eloquent 全局作用域，确保 Question 模型始终只返回关联未被软删除用户的记录，解决 Question::find() 返回关联已软删除用户数据的问题。

本文介绍如何通过 eloquent 全局作用域，确保 `question` 模型始终只返回关联未被软删除用户的记录，解决 `question::find()` 返回关联已软删除用户数据的问题。

在 Laravel 中，软删除（Soft Deletes）通过 deleted_at 字段标记记录状态，但默认情况下，Eloquent 的关联关系（如 belongsTo）不会自动过滤软删除的父级模型。正如你在 Question 模型中定义的：

public function user()
{
    return $this->belongsTo("App\User")->whereNull('deleted_at');
}

这段代码仅影响显式调用该关联时的查询条件（例如 $question->user 或 with('user')），而 不影响 Question 本身的查询逻辑——也就是说，Question::find(1)、Question::all() 或 Question::where(...)->get() 等操作仍会返回所有问题，无论其关联用户是否已被软删除。

要实现「全系统一致过滤」，即任何对 Question 的查询（包括 find()、first()、get() 等）都自动排除关联用户已软删除的记录，必须使用 全局作用域（Global Scope）。

✅ 正确方案：添加全局作用域

在 App\Question 模型中添加以下代码（推荐使用静态 booted() 方法）：

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

use Illuminate\Database\Eloquent\Builder;

class Question extends Model
{
    protected $fillable = ['title', 'question'];

    public function user()
    {
        return $this->belongsTo(User::class)->whereNull('deleted_at');
    }

    protected static function booted()
    {
        static::addGlobalScope('activeUsers', function (Builder $builder) {
            $builder->whereHas('user', function ($query) {
                $query->whereNull('deleted_at');
            });
        });
    }
}

? 注意：whereHas('user', ...) 会生成 INNER JOIN（或子查询），确保仅保留 user 存在且 deleted_at IS NULL 的 Question 记录。这正是你期望的“严格关联过滤”。

⚠️ 重要注意事项

全局作用域默认启用：一旦注册，所有 Eloquent 查询（含 find()、firstOrFail()、paginate() 等）均受其约束。
可临时禁用：如需获取包含软删除用户的问题（如后台管理场景），可使用 withoutGlobalScopes()：
```
Question::withoutGlobalScopes()->find(1);
// 或禁用特定作用域
Question::withoutGlobalScope('activeUsers')->get();
```
避免重复加载关联：若同时使用 with('user')，whereHas 已确保用户存在且未软删除，with 将复用相同条件（Laravel 会优化），无需额外 whereNull('deleted_at')。
迁移兼容性：确保 users 表存在 deleted_at 字段（已启用 SoftDeletes trait），否则查询将报错。

✅ 验证效果

执行以下代码后，将只返回用户未被软删除的问题：

// ✅ 返回 null（若该 question 关联的是软删除用户）
$question = Question::find(123);

// ✅ 返回有效集合（自动过滤掉无效关联）
$questions = Question::where('title', 'like', '%Laravel%')->get();