Laravel Eloquent 多对多关系：实现用户互赞匹配功能-php教程-PHP中文网

Laravel Eloquent 多对多关系：实现用户互赞匹配功能

心靈之曲

发布： 2025-10-23 10:07:18

原创

420人浏览过

Laravel Eloquent 多对多关系：实现用户互赞匹配功能

本文深入探讨了在 laravel 中构建类似 tinder 的互赞匹配功能时，如何正确定义 eloquent 多对多关系。通过分析常见错误，并提供基于自连接（self-join）的解决方案，文章展示了如何高效地查询并获取用户之间的双向匹配，同时涵盖了数据库迁移和数据填充的最佳实践，确保关系模型的准确性和性能。

在开发社交应用时，实现用户间的“互赞”或“匹配”功能是一个常见的需求。这通常涉及到复杂的自引用多对多关系。Laravel 的 Eloquent ORM 提供了强大的关系定义能力，但若处理不当，可能会遇到查询结果为空或性能低下的问题。本教程将详细介绍如何在 Laravel 中构建一个健壮的互赞匹配系统。

理解互赞关系的复杂性

一个用户“喜欢”另一个用户，是一个单向行为。而“匹配”则意味着两个用户都互相喜欢。在数据库层面，这通常通过一个中间表（枢纽表）来记录。例如，一个 users_users_liked 表可以存储 user_id 喜欢 user_liked_id 的记录。

为了实现互赞匹配，我们需要查询那些既被当前用户喜欢，又喜欢当前用户的用户。

初始关系定义与常见错误分析

假设我们有一个 User 模型，并定义了以下关系来表示单向喜欢：

// app/Models/User.php

class User extends Model
{
    // 用户喜欢了哪些其他用户
    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');
    }
}

登录后复制

基于上述单向关系，开发者可能会尝试定义一个 matches 关系，如下所示：

// 错误的 matches 关系定义示例
public function matches()
{
    // 尝试在关系定义中使用已加载的集合
    return $this->likesFromUsers()->whereIn('user_id', $this->likesToUsers->keyBy('id'));
}

登录后复制

这种定义方式存在以下几个核心问题：

keyBy('id') 的误用：keyBy('id') 会返回一个以 id 为键，模型实例为值的集合。whereIn 方法期望接收一个 ID 数组，因此应使用 pluck('id') 来获取纯粹的 ID 数组。
在关系定义中依赖已加载的集合：最根本的问题在于，在定义 Eloquent 关系时，我们不能直接依赖于 $this-youjiankuohaophpcnlikesToUsers 这种已加载的集合。当 Eloquent 尝试预加载 matches 关系时，$this->likesToUsers 尚未被加载（或者在加载多个模型时，它可能只代表第一个模型的 likesToUsers 集合，导致其他模型的匹配关系错误）。Eloquent 关系定义需要的是一个可查询的构建器，而不是一个具体的模型实例集合。

解决方案：基于自连接（Self-Join）的 matches 关系

为了正确实现互赞匹配，我们需要在数据库层面通过连接（Join）枢纽表自身来查找双向喜欢。这可以通过 Eloquent 关系结合 join 子句实现。

以下是 matches 关系的正确定义：

// app/Models/User.php

use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Query\JoinClause;

class User extends Model
{
    // ... 其他关系定义 ...

    /**
     * 获取与当前用户互赞匹配的用户
     */
    public function matches(): BelongsToMany
    {
        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'); // 另一个用户喜欢了当前用户，且被当前用户喜欢
            });
    }
}

登录后复制

代码解析：

$this->likesFromUsers(): 这首先构建了一个查询，用于获取那些喜欢当前用户的用户。
join('users_users_liked as alt_users_users_liked', ...): 我们将 users_users_liked 枢纽表再次连接到自身，并为其设置一个别名 alt_users_users_liked。
$join->on('users_users_liked.user_liked_id', '=', 'alt_users_users_liked.user_id'): 这个条件确保了 users_users_liked 表中的 user_liked_id（即当前用户被喜欢）与 alt_users_users_liked 表中的 user_id（即另一个用户喜欢了某人）相匹配。
$join->on('users_users_liked.user_id', '=', 'alt_users_users_liked.user_liked_id'): 这个条件则确保了 users_users_liked 表中的 user_id（即当前用户喜欢了某人）与 alt_users_users_liked 表中的 user_liked_id（即另一个用户被喜欢）相匹配。

这两个 on 条件共同确保了我们找到的是一个双向的喜欢关系，即 A喜欢B 且 B喜欢A。

多墨智能

多墨智能 - AI 驱动的创意工作流写作工具

108

查看详情

使用示例：

$user = User::with('matches')->findOrFail(1);
foreach ($user->matches as $matchedUser) {
    echo $matchedUser->name . " is a match!\n";
}

登录后复制

数据库迁移最佳实践

为了确保数据库的完整性和代码的简洁性，推荐在枢纽表迁移中使用以下最佳实践：

使用 foreignId()->constrained()：Laravel 8+ 提供了更简洁的 foreignId() 方法来定义外键。

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

class CreateUsersUsersLikedTable extends Migration
{
    public function up()
    {
        Schema::create('users_users_liked', function (Blueprint $table) {
            $table->id(); // 使用 id() 替代 increments('id')
            $table->foreignId('user_id')
                  ->constrained('users') // 关联到 users 表的 id 字段
                  ->cascadeOnDelete() // 父记录删除时，子记录也删除
                  ->cascadeOnUpdate(); // 父记录更新时，子记录也更新

            $table->foreignId('user_liked_id')
                  ->constrained('users')
                  ->cascadeOnDelete()
                  ->cascadeOnUpdate();

            $table->timestamps();

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

    public function down()
    {
        Schema::dropIfExists('users_users_liked');
    }
}

登录后复制

添加唯一约束：在枢纽表中添加 unique(['user_id', 'user_liked_id']) 约束非常重要。这可以防止同一个用户多次喜欢另一个用户，确保数据的唯一性和一致性。

数据填充与测试建议

手动使用 attach 方法填充大量数据进行测试可能效率低下且难以维护。推荐使用 Laravel 的模型工厂 (Model Factories) 来生成测试数据。

示例模型工厂：

// database/factories/UserFactory.php
use App\Models\User;
use Illuminate\Database\Eloquent\Factories\Factory;

class UserFactory extends Factory
{
    protected $model = User::class;

    public function definition()
    {
        return [
            'name' => $this->faker->name(),
            'email' => $this->faker->unique()->safeEmail(),
            'password' => '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9zhm/L.h.P.S8B.y9d2P.I', // password
        ];
    }
}

登录后复制

在 Seeder 中使用：

// database/seeders/UserSeeder.php
use App\Models\User;
use Illuminate\Database\Seeder;

class UserSeeder extends Seeder
{
    public function run()
    {
        User::factory()->count(10)->create()->each(function ($user) {
            // 让每个用户随机喜欢其他一些用户
            $likedUsers = User::inRandomOrder()->limit(rand(0, 5))->get()->except($user->id);
            $user->likesToUsers()->attach($likedUsers);
        });

        // 确保某些用户之间存在互赞关系以便测试
        $user1 = User::find(1);
        $user2 = User::find(2);

        if ($user1 && $user2) {
            $user1->likesToUsers()->attach($user2->id);
            $user2->likesToUsers()->attach($user1->id);
        }
    }
}

登录后复制

总结

在 Laravel 中实现互赞匹配功能需要对 Eloquent 关系和 SQL 连接有深入的理解。关键在于避免在关系定义中依赖已加载的集合，而是利用数据库层面的自连接来精确地查询双向关系。结合 foreignId()->constrained() 简化迁移和添加唯一约束来保证数据完整性，将使你的应用更加健壮和高效。通过采用模型工厂进行数据填充，可以极大地提高开发和测试效率。

以上就是Laravel Eloquent 多对多关系：实现用户互赞匹配功能的详细内容，更多请关注php中文网其它相关文章！