Laravel 中实现双向匹配关系的 Eloquent 教程-php教程-PHP中文网

Laravel 中实现双向匹配关系的 Eloquent 教程

聖光之護

发布： 2025-10-23 08:58:31

原创

123人浏览过

laravel 中实现双向匹配关系的 eloquent 教程

本文深入探讨了在 Laravel 应用中构建类似 Tinder 的双向匹配（mutual match）关系。针对初始尝试中 `matches` 关系为空的问题，我们分析了其根本原因，即在关系定义中依赖未加载的模型实例。核心解决方案是利用数据库 `JOIN` 操作直接在 Eloquent 关系中识别双向匹配，并提供了优化 `pivot` 表迁移和添加唯一约束的最佳实践，确保数据完整性和关系定义的准确性。

在构建社交应用，特别是像 Tinder 这样需要用户之间“互相喜欢”才能形成匹配的场景时，正确地定义 Eloquent 关系至关重要。本文将详细讲解如何在 Laravel 中实现这一复杂的双向匹配关系，并提供优化方案。

理解初始实现的问题

许多开发者在尝试实现双向匹配时，可能会倾向于在 matches 关系中结合已有的 likesToUsers 和 likesFromUsers 关系。例如，以下是一种常见的错误尝试：

// User Model (Incorrect Implementation)
public function likesToUsers()
{
    return $this->belongsToMany(self::class, 'users_users_liked', 'user_id', 'user_liked_id');
}

public function likesFromUsers()
{
    return $this->belongsToMany(self::class, 'users_users_liked', 'user_liked_id', 'user_id');
}

public function matches()
{
    // 这种方式在 eager loading 时会失败
    return $this->likesFromUsers()->whereIn('user_id', $this->likesToUsers->keyBy('id'));
}

登录后复制

这种实现方式存在几个关键问题：

keyBy 与 pluck 的混淆：whereIn 方法期望一个 ID 数组，而 $this-youjiankuohaophpcnlikesToUsers->keyBy('id') 返回的是一个以 ID 为键、模型实例为值的集合。正确的做法应该是使用 pluck('id') 来获取 ID 数组。
Eager Loading 的限制：最核心的问题在于，在定义 Eloquent 关系时，你不能直接依赖于当前模型实例的已加载关系数据（如 $this->likesToUsers）。当 Laravel 尝试进行预加载（eager loading）时，$this->likesToUsers 尚未被加载，或者在加载多个模型时，它可能只使用了第一个模型的关联值，导致其他模型的匹配关系不准确。关系定义应该基于数据库层面的逻辑，而不是基于已加载的模型状态。

简而言之，尝试在关系定义中直接使用一个已加载关系的“值”来过滤另一个关系，在预加载场景下是不可行的。

正确实现双向匹配关系

要正确实现双向匹配，我们需要利用数据库的 JOIN 操作来直接在数据库层面找出相互喜欢的用户。这可以通过将 pivot 表自身连接两次来实现。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Query\JoinClause; // 引入 JoinClause

class User extends Model
{
    use HasFactory;

    protected $guarded = [];

    /**
     * 用户喜欢的其他用户
     */
    public function likesToUsers()
    {
        return $this->belongsToMany(self::class, 'users_users_liked', 'user_id', 'user_liked_id');
    }

    /**
     * 喜欢当前用户的其他用户
     */
    public function likesFromUsers()
    {
        return $this->belongsToMany(self::class, 'users_users_liked', 'user_liked_id', 'user_id');
    }

    /**
     * 获取与当前用户形成双向匹配的用户
     */
    public function matches()
    {
        return $this->likesFromUsers()
            ->join('users_users_liked as alt_users_users_liked', function (JoinClause $join) {
                $join->on('users_users_liked.user_liked_id', '=', 'alt_users_users_liked.user_id')
                     ->on('users_users_liked.user_id', '=', 'alt_users_users_liked.user_liked_id');
            });
    }
}

登录后复制

解析 matches() 方法：

$this->likesFromUsers()：这首先构建了一个查询，查找所有喜欢当前用户的用户。它基于 users_users_liked 表（在这里是主表，别名为 users_users_liked）。
join('users_users_liked as alt_users_users_liked', ...)：我们再次连接 users_users_liked 表，但这次给它一个不同的别名 alt_users_users_liked。
function (JoinClause $join)：在连接回调中定义连接条件。
- $join->on('users_users_liked.user_liked_id', '=', 'alt_users_users_liked.user_id')：这个条件确保了如果主表中的 user_liked_id（即当前用户）被 alt_users_users_liked 表中的 user_id（即另一个用户）喜欢。
- $join->on('users_users_liked.user_id', '=', 'alt_users_users_liked.user_liked_id')：这个条件则确保了主表中的 user_id（即另一个用户）被 alt_users_users_liked 表中的 user_liked_id（即当前用户）喜欢。

通过这两个 ON 条件，我们有效地筛选出了那些在 users_users_liked 表中存在双向记录的用户，从而实现了双向匹配。

琅琅配音

全能AI配音神器

查看详情

优化 Pivot 表迁移

为了提升代码的简洁性和数据库的健壮性，我们可以优化 users_users_liked 迁移文件。

原始迁移：

Schema::create('users_users_liked', function (Blueprint $table) {
    $table->increments('id');
    $table->unsignedInteger('user_id')->index();
    $table->foreign('user_id')->references('id')->on('users')->onDelete('cascade')->onUpdate('cascade');
    $table->unsignedInteger('user_liked_id')->nullable()->index(); // nullable 可能不是最佳实践
    $table->foreign('user_liked_id')->references('id')->on('users')->onDelete('cascade')->onUpdate('cascade');
    $table->timestamps();
});

登录后复制

优化后的迁移：

Laravel 提供了 foreignId() 方法，可以简化外键的定义，并链式调用 constrained() 来自动推断表名和列名。同时，添加唯一约束可以防止用户重复喜欢同一个用户。

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('users_users_liked', function (Blueprint $table) {
            $table->id(); // 使用 id() 替代 increments('id')
            $table->foreignId('user_id')->constrained()->cascadeOnDelete()->cascadeOnUpdate();
            $table->foreignId('user_liked_id')->constrained('users')->cascadeOnDelete()->cascadeOnUpdate();
            $table->timestamps();

            // 添加唯一约束，防止重复喜欢
            $table->unique(['user_id', 'user_liked_id']);
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('users_users_liked');
    }
};

登录后复制

优化说明：

$table->id()：这是 increments('id') 的更简洁写法。
$table->foreignId('user_id')->constrained()->cascadeOnDelete()->cascadeOnUpdate()：foreignId() 会创建一个 UNSIGNED BIGINT 类型的列。constrained() 会自动尝试将 user_id 关联到 users 表的 id 列。cascadeOnDelete() 和 cascadeOnUpdate() 则定义了级联操作。
$table->foreignId('user_liked_id')->constrained('users')->cascadeOnDelete()->cascadeOnUpdate()：这里明确指定了 constrained('users')，因为列名 user_liked_id 不直接对应 users 表的命名规范，但其含义仍然是引用 users 表。
$table->unique(['user_id', 'user_liked_id'])：这是一个非常重要的优化，它确保了任何一对用户之间只能存在一条“喜欢”记录，避免了数据冗余和逻辑错误。

总结

通过上述修正和优化，我们成功地在 Laravel 中实现了一个健壮且高效的双向匹配关系。核心在于理解 Eloquent 关系的本质，避免在关系定义中依赖运行时状态，而是利用数据库层面的 JOIN 操作来精确筛选数据。同时，遵循最佳实践来设计和优化 pivot 表，可以进一步提升应用的数据完整性和可维护性。在实际开发中，结合 Model Factories 来填充测试数据，将有助于验证这些关系的正确性。

以上就是Laravel 中实现双向匹配关系的 Eloquent 教程的详细内容，更多请关注php中文网其它相关文章！