Laravel 8 中高效检索用户好友列表并支持姓名/邮箱模糊搜索-php教程-PHP中文网

Laravel 8 中高效检索用户好友列表并支持姓名/邮箱模糊搜索

本文详解如何在 Laravel 8 中基于双向好友关系（FriendList 表）精准筛选出当前用户的个体型好友（is_individual = 1），并支持按姓名或邮箱关键词模糊搜索，兼顾性能与可读性。

本文详解如何在 laravel 8 中基于双向好友关系（`friendlist` 表）精准筛选出当前用户的个体型好友（`is_individual = 1`），并支持按姓名或邮箱关键词模糊搜索，兼顾性能与可读性。

在 Laravel 8 开发中，实现「仅从当前用户的好友中搜索符合条件的个体用户」是一个典型但易出错的场景。原始方案存在明显缺陷：两次独立查询（先查好友 ID 再查用户）、N+1 风险隐患、逻辑耦合度高，且未正确处理好友关系的双向性（即 user_id → to_id 和 to_id → user_id 均需纳入匹配）。

✅ 推荐方案：使用 Eloquent 关联 + 子查询优化

首先，在 User 模型中正确定义好友关系（注意：因 FriendList 是多对多中间表的简化形式，需同时支持两个方向）：

// app/Models/User.php
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Database\Eloquent\Relations\HasMany;

class User extends Authenticatable
{
    // ...其他代码

    /**
     * 获取该用户作为「发起方」的好友记录（user_id = 当前用户ID）
     */
    public function sentFriends(): HasMany
    {
        return $this->hasMany(FriendList::class, 'user_id', 'id');
    }

    /**
     * 获取该用户作为「接收方」的好友记录（to_id = 当前用户ID）
     */
    public function receivedFriends(): HasMany
    {
        return $this->hasMany(FriendList::class, 'to_id', 'id');
    }

    /**
     * 获取所有直接好友（合并发起和接收关系）
     */
    public function friends()
    {
        return $this->belongsToMany(User::class, 'friend_lists', 'user_id', 'to_id')
            ->withPivot('id') // 可选：若需访问中间表字段
            ->using(FriendList::class);
    }
}

⚠️ 注意：belongsToMany 默认使用 user_id/to_id 字段，恰好匹配你的表结构，无需额外中间模型即可启用关联查询。

Laravel
避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

接下来，在控制器中执行单次高效查询，利用 whereExists 精准表达“既是好友，又是个体用户”的双重约束：

// 在控制器中（例如 FriendController@search）
use App\Models\User;
use Illuminate\Http\Request;

public function search(Request $request)
{
    $userId = auth()->id();
    $search = $request->input('search', '');

    $query = User::where('is_individual', 1); // 先限定为个体用户

    // 使用 whereExists 确保该用户是当前登录用户的双向好友
    $query->whereExists(function ($sub) use ($userId) {
        $sub->from('friend_lists')
            ->whereRaw('friend_lists.user_id = users.id AND friend_lists.to_id = ?', [$userId])
            ->orWhereRaw('friend_lists.to_id = users.id AND friend_lists.user_id = ?', [$userId]);
    });

    // 支持姓名或邮箱模糊搜索（注意：避免空搜索导致全表扫描）
    if (!empty($search)) {
        $query->where(function ($q) use ($search) {
            $q->where('name', 'like', "%{$search}%")
              ->orWhere('email', 'like', "%{$search}%");
        });
    }

    $results = $query->select('id', 'name', 'email', 'is_individual')->get();

    return response()->json($results);
}