Laravel-MongoDB 项目中的写入操作详解

Laravel-MongoDB 项目中的写入操作详解

laravel-mongodb A MongoDB based Eloquent model and Query builder for Laravel (Moloquent) 项目地址: https://gitcode.com/gh_mirrors/la/laravel-mongodb

概述

在 Laravel 中使用 MongoDB 进行数据操作时，Laravel-MongoDB 项目提供了丰富的写入操作方法。本文将详细介绍如何使用这个项目进行各种写入操作，包括插入、更新和删除文档等核心功能。

插入操作

单文档插入

在 MongoDB 中插入单个文档非常简单，使用 Eloquent 模型的 create 方法即可：

SampleModel::create([
    'name' => 'John Doe',
    'email' => 'john@example.com',
    'age' => 30
]);

这种方法会自动处理时间戳（如果模型启用了 timestamps），并且会返回新创建的模型实例。

批量插入

当需要插入多个文档时，可以使用 insert 方法提高效率：

SampleModel::insert([
    [
        'name' => 'Alice',
        'email' => 'alice@example.com',
        'age' => 25
    ],
    [
        'name' => 'Bob',
        'email' => 'bob@example.com',
        'age' => 28
    ]
]);

批量插入不会触发模型的 created 事件，也不会自动处理时间戳，因此适合大量数据导入场景。

更新操作

单文档更新

更新单个文档通常需要先查询到该文档，然后调用 update 方法：

SampleModel::where('email', 'john@example.com')
    ->orderBy('created_at')
    ->first()
    ->update([
        'age' => 31
    ]);

这种方法会触发模型的 updated 事件，并自动更新时间戳。

批量更新

直接更新多个匹配的文档：

SampleModel::where('age', '>', 25)
    ->update(['status' => 'senior']);

批量更新同样不会触发模型事件，但效率更高。

Upsert 操作

Upsert 是 update 和 insert 的结合，当文档不存在时插入新文档：

// 方法一：使用 update 的 upsert 选项
SampleModel::where(['email' => 'new@example.com'])
    ->update(
        ['name' => 'New User', 'age' => 20],
        ['upsert' => true]
    );

// 方法二：使用专门的 upsert 方法
SampleModel::upsert(
    [
        ['email' => 'user1@example.com', 'name' => 'User One'],
        ['email' => 'user2@example.com', 'name' => 'User Two']
    ],
    'email',
    ['name']
);

第二种方法特别适合批量处理，其中第二个参数指定唯一标识字段，第三个参数指定需要更新的字段。

删除操作

单文档删除

删除单个文档的推荐方式：

SampleModel::where('email', 'john@example.com')
    ->orderBy('created_at')
    ->limit(1)
    ->delete();

这会触发模型的 deleted 事件。

批量删除

删除所有匹配条件的文档：

SampleModel::where('status', 'inactive')
    ->delete();

批量删除不会触发单个模型的 deleted 事件。

最佳实践

1. 事务支持：对于关键业务操作，考虑使用 MongoDB 的事务功能确保数据一致性。

2. 批量操作性能：当处理大量数据时，批量操作比循环单条操作效率高得多。

3. 事件触发：注意不同操作方法是否会触发模型事件，根据业务需求选择合适的方法。

4. 索引优化：确保查询条件字段有适当索引，特别是对于更新和删除操作。

5. 原子操作：MongoDB 支持丰富的原子操作符，如 $inc、$push 等，可以在 Laravel-MongoDB 中通过原生查询使用。

通过掌握这些写入操作方法，你可以高效地在 Laravel 应用中操作 MongoDB 数据，满足各种业务场景的需求。

laravel-mongodb A MongoDB based Eloquent model and Query builder for Laravel (Moloquent) 项目地址: https://gitcode.com/gh_mirrors/la/laravel-mongodb