Laravel中如何正确使用firstOrNew()防止数据库数据重复-php教程-PHP中文网

Laravel中如何正确使用firstOrNew()防止数据库数据重复

本文旨在详细阐述在laravel应用中，如何有效利用firstornew()方法来防止数据库中出现重复数据。我们将重点纠正常见的误用，强调将所有构成唯一性的属性组合作为firstornew()方法第一个参数的关键作用，确保在用户多次提交相同数据时，系统能够正确识别并避免创建冗余记录，从而维护数据完整性。

引言：数据库数据去重的重要性

在Web应用开发中，防止数据库中出现重复数据是一项基本而重要的任务。例如，在一个招聘系统中，用户不应该能够多次申请同一个职位；在一个电商平台，用户不应该重复提交相同的订单。重复数据不仅会污染数据库，降低数据质量，还可能导致业务逻辑错误，影响用户体验。

Laravel框架提供了多种便捷的方法来处理数据库操作，其中firstOrNew()方法就是一种用于查找现有记录或创建新记录的强大工具。然而，如果不正确使用，它可能会导致意想不到的结果，甚至无法有效阻止数据重复。

firstOrNew()的常见误解与陷阱

firstOrNew()方法接收两个参数：

$attributes：一个数组，用于构建查询条件。如果数据库中存在与这些属性匹配的记录，则返回该记录。
$values：一个数组，如果数据库中未找到匹配记录，则在创建新的模型实例时，除了$attributes中的属性外，还会用$values中的属性填充该新实例。

一个常见的误用场景是，开发者可能只将部分构成唯一性的属性放入第一个$attributes数组，而将其他关键属性放入第二个$values数组，或者更甚者，尝试使用布尔逻辑组合条件。

例如，在防止用户重复申请职位的场景中，如果只根据user_id来查找，并将posts_id放在第二个参数中：

// 错误示例：仅根据用户ID查找，导致用户无法申请其他职位
$apply = Applies::firstOrNew(
    ['user_id' => Auth::id()], // 仅根据用户ID查找
    ['posts_id' => request('id')] // 岗位ID被作为新模型的填充属性
);
$apply->save();

登录后复制

这段代码的意图是防止用户重复申请，但其逻辑是错误的。如果用户已经申请过任何一个职位，firstOrNew()会找到该用户的第一条申请记录（因为只匹配了user_id），并返回这个现有模型实例。此时，即使用户正在申请一个全新的职位，$apply->save()也只会更新现有记录（如果posts_id在第二个数组中，可能会更新其posts_id，但更常见的是，如果posts_id不是主键或唯一约束，它会返回现有记录而不做任何修改，从而阻止了新申请的创建），或者直接返回现有记录，导致用户无法创建新的申请记录，即使是针对不同的职位。这显然不符合“防止用户重复申请同一个职位”的业务需求。

另一种错误的尝试可能是：

// 另一个错误示例：尝试使用布尔逻辑组合条件
$apply = Applies::firstOrNew(
    ['user_id' => Auth::id()] && ['posts_id' => request('id')], // 这是一个布尔表达式，不是数组
    ['user_id' => request(Auth::id())], // 这里的Auth::id()应直接作为值
    ['posts_id' => request('id')]
);
$apply->save();

登录后复制

这段代码的问题在于，['user_id' => Auth::id()] && ['posts_id' => request('id')]会计算为一个布尔值（true或false），而不是一个包含查询条件的数组。firstOrNew()的第一个参数必须是一个数组。

firstOrNew()的正确用法解析

firstOrNew()的核心原理在于，它的第一个参数$attributes数组应该包含所有构成记录唯一性的属性。只有当数据库中不存在完全匹配这些属性组合的记录时，firstOrNew()才会创建一个新的模型实例。

在我们的职位申请示例中，一条申请记录的唯一性是由user_id（用户ID）和posts_id（职位ID）的组合来定义的。也就是说，同一个用户不能申请同一个职位两次，但可以申请不同的职位。

因此，正确的做法是将user_id和posts_id都包含在firstOrNew()的第一个$attributes数组中：

降重鸟

要想效果好，就用降重鸟。AI改写智能降低AIGC率和重复率。

113

查看详情

// 正确示例：根据用户ID和岗位ID组合查找
use Illuminate\Support\Facades\Auth;
use App\Models\Applies; // 假设你的模型名为Applies

public function applyJob(Request $request)
{
    // 获取当前认证用户的ID和请求中的职位ID
    $userId = Auth::id();
    $postId = $request->input('id'); // 或者 $request->id;

    // 尝试查找是否存在用户已申请该职位的记录
    // 如果存在，返回现有记录；如果不存在，创建一个新的Applies模型实例
    $apply = Applies::firstOrNew([
        'user_id' => $userId,
        'posts_id' => $postId,
    ]);

    // 检查模型是否是新创建的实例
    if ($apply->exists) {
        // 记录已存在，用户已申请过该职位
        return back()->with('error', '您已申请过该职位，请勿重复申请！');
    } else {
        // 记录是新创建的实例，可以进行保存操作
        // 可以在这里设置其他属性，例如申请时间、状态等
        // $apply->status = 'pending';
        // $apply->applied_at = now();

        $apply->save(); // 将新的申请记录保存到数据库

        return back()->with('success', '职位申请成功！');
    }
}

登录后复制

代码解释：

Applies::firstOrNew(['user_id' => $userId, 'posts_id' => $postId])：
- Laravel会首先执行一个查询，查找Applies表中user_id等于$userId且posts_id等于$postId的记录。
- 如果找到了这样的记录，firstOrNew()会返回这个已存在的Applies模型实例。此时，$apply->exists会是true。
- 如果未找到这样的记录，firstOrNew()会创建一个新的Applies模型实例，并用['user_id' => $userId, 'posts_id' => $postId]中的值填充它。此时，$apply->exists会是false。
if ($apply->exists)：通过检查exists属性，我们可以判断返回的模型实例是来自数据库的现有记录还是一个新创建的实例。
$apply->save()：如果模型是新创建的，此方法会将其保存到数据库中。如果模型是现有记录，且没有其他属性被修改，save()方法将不会执行任何数据库更新操作。

通过这种方式，我们确保了只有当user_id和posts_id的组合在数据库中不存在时，才会创建新的申请记录，从而有效地防止了重复提交。

注意事项与最佳实践

数据库唯一索引： 即使在应用层使用了firstOrNew()来防止重复，强烈建议在数据库层面为构成唯一性的字段组合添加唯一索引。这提供了额外的保障，防止在并发请求或其他应用逻辑错误时可能发生的重复数据，同时也能提升查询性能。

对于applies表，你可以在迁移文件中添加一个复合唯一索引：
```
Schema::create('applies', function (Blueprint $table) {
    $table->id();
    $table->foreignId('user_id')->constrained()->onDelete('cascade');
    $table->foreignId('posts_id')->constrained('posts')->onDelete('cascade');
    // 其他字段...
    $table->timestamps();

    // 添加复合唯一索引
    $table->unique(['user_id', 'posts_id']);
});
```
登录后复制
如果应用层逻辑未能阻止重复插入，数据库的唯一索引会在尝试插入重复数据时抛出异常，此时你可以在代码中捕获这个异常并进行相应的处理。

错误处理： 当数据库存在唯一索引时，$apply->save()操作可能会因为唯一性约束冲突而抛出Illuminate\Database\QueryException。为了提供更友好的用户体验，你应该捕获并处理这个异常：

use Illuminate\Database\QueryException;

try {
    $apply->save();
    return back()->with('success', '职位申请成功！');
} catch (QueryException $e) {
    // 检查异常是否是由于唯一性约束冲突引起的
    if (str_contains($e->getMessage(), 'Duplicate entry')) {
        return back()->with('error', '您已申请过该职位，请勿重复申请！');
    }
    // 处理其他数据库异常
    return back()->with('error', '申请失败，请稍后再试。');
}

登录后复制

其他类似方法： Laravel还提供了其他用于查找或创建/更新记录的方法，它们各有适用场景：
- firstOrCreate(array $attributes, array $values = [])：与firstOrNew()类似，但如果记录不存在，它会立即创建并保存到数据库。适用于你希望立即持久化新记录的场景。
- updateOrCreate(array $attributes, array $values = [])：如果找到匹配$attributes的记录，则使用$values更新它；否则，创建新记录并用$attributes和$values填充。适用于需要更新现有记录或创建新记录的场景。
- firstOrFail(array $attributes)：查找匹配$attributes的记录，如果未找到，则抛出ModelNotFoundException。

选择哪种方法取决于你的具体业务逻辑需求。firstOrNew()的优势在于它允许你在将新模型保存到数据库之前，对其进行额外的操作或条件判断。

总结

正确使用firstOrNew()方法是Laravel中防止数据库数据重复的关键一环。核心在于理解其第一个参数$attributes的作用，它必须包含所有定义记录唯一性的属性组合。结合数据库层面的唯一索引和适当的异常处理，可以构建一个健壮的系统来有效管理数据完整性，提升应用的用户体验和可靠性。始终记住，明确哪些属性的组合构成了“唯一性”，是成功应用此方法的基石。

以上就是Laravel中如何正确使用firstOrNew()防止数据库数据重复的详细内容，更多请关注php中文网其它相关文章！