基于用户权限动态限制Laravel Scout搜索/返回字段的实现

我之前在项目里刚好实现过类似的需求，这两个问题都可以通过Scout的灵活扩展和Meilisearch的原生特性来解决，下面给你详细拆解：

一、动态限制搜索字段与返回字段 #

1. 限制搜索字段（根据权限调整可搜索属性） #

Scout默认用模型的toSearchableArray()定义索引字段，但要动态控制哪些字段允许被搜索，可以利用Meilisearch的attributesToSearchOn查询参数，结合当前用户权限动态设置：

// 推荐在控制器或专门的搜索服务类中处理权限逻辑
public function searchUsers(Request $request)
{
    $query = $request->input('q');
    $currentUser = auth()->user();

    // 基础可搜索字段：所有用户都能搜name和email
    $allowedSearchFields = ['name', 'email'];
    
    // 管理员额外允许搜索phone
    if ($currentUser->isAdmin()) { // 假设你有判断管理员的方法
        $allowedSearchFields[] = 'phone';
    }

    // 构建Scout查询并注入Meilisearch原生选项
    $searchResults = User::search($query)
        ->raw() // 启用原生Meilisearch查询模式
        ->setOptions([
            'attributesToSearchOn' => $allowedSearchFields,
        ])->get();

    return view('users.search', compact('searchResults'));
}

2. 限制返回字段（根据权限控制结果包含的属性） #

要控制搜索结果返回哪些字段，可以用Meilisearch的attributesToRetrieve参数，或者直接用Scout的select()方法（底层会自动映射到attributesToRetrieve）：

// 接上面的代码，添加返回字段控制
$allowedRetrieveFields = ['id', 'name', 'email'];
if ($currentUser->isAdmin()) {
    $allowedRetrieveFields[] = 'phone';
}

// 方式一：用Scout的select()方法（更符合Laravel风格）
$searchResults = User::search($query)
    ->select($allowedRetrieveFields)
    ->get();

// 方式二：用原生选项（适合更复杂的配置）
$searchResults = User::search($query)
    ->raw()
    ->setOptions([
        'attributesToSearchOn' => $allowedSearchFields,
        'attributesToRetrieve' => $allowedRetrieveFields,
    ])->get();

注意：如果你的模型索引时包含了phone字段，但普通用户搜索时看不到，不用担心——Meilisearch会严格按照attributesToRetrieve返回字段，未授权的字段不会出现在结果里。

二、获取搜索结果的权重值（Ranking Score） #

Meilisearch会给每个搜索结果返回一个_rankingScore字段，代表该结果的匹配权重，但Scout默认不会把这个字段映射到Eloquent模型中。你可以通过两种方式获取：

1. 直接获取原生结果中的权重 #

使用raw()方法获取Meilisearch的原始响应，里面的hits数组就包含_rankingScore：

$rawResults = User::search('John')->raw();

foreach ($rawResults['hits'] as $hit) {
    echo "用户ID: {$hit['id']}, 匹配权重: {$hit['_rankingScore']}";
}

2. 将权重附加到Eloquent模型实例 #

如果你希望在Eloquent模型中直接访问权重值，可以用transform()方法把权重注入模型：

$searchQuery = User::search('John');
$rawResults = $searchQuery->raw();

// 把权重附加到每个模型实例
$results = $searchQuery->get()->transform(function ($user) use ($rawResults) {
    // Meilisearch的ID默认是字符串，注意类型匹配
    $hit = collect($rawResults['hits'])->firstWhere('id', (string)$user->id);
    $user->ranking_score = $hit['_rankingScore'] ?? 0;
    return $user;
});

// 之后就可以直接调用：$user->ranking_score

一些额外建议 #

• 把权限判断逻辑封装到专门的SearchService类中，避免控制器代码臃肿，也方便复用。
• 确保你的Meilisearch版本在v0.27+（attributesToSearchOn和_rankingScore都是这个版本后稳定支持的）。
• 如果需要全局搜索多个模型，可以在SearchService中统一处理每个模型的权限字段。

内容的提问来源于stack exchange，提问作者Kieran