更新文档

在本页

示例

您可以通过检索单个文档并调用 Eloquent 模型或查询构建器的update() 方法来更新集合中的文档。

将查询过滤器传递给 where() 方法，排序匹配的文档，并调用 first() 方法以仅检索第一个文档。然后，通过将预期的文档更改传递给 update() 方法来更新此匹配的文档。

示例

本用法示例执行以下操作

使用 Movie Eloquent 模型来表示 sample_mflix 数据库中的 movies 集合
更新与查询过滤器匹配的 movies 集合中的文档
打印已更新的文档数量

示例在 Movie 模型上调用以下方法

where()：匹配标题字段值为 "Carol" 的文档。
orderBy()：按升序 _id 值对匹配的文档进行排序。
first()：仅检索第一个匹配的文档。
update()：将嵌套字段 imdb.rating 的值从 6.9 更新为 7.3，并将嵌套字段 imdb.votes 的值从 493 更新为 142000。

$updates = Movie::where('title', 'Carol')
    ->orderBy('id')
    ->first()
    ->update([
        'imdb' => [
            'rating' => 7.3,
            'votes' => 142000,
        ],
    ]);
echo 'Updated documents: ' . $updates;

Updated documents: 1

要了解如何编辑您的 Laravel 应用以运行用法示例，请参阅用法示例首页.

提示

要了解更多关于使用 Laravel 集成更新数据的信息，请参阅写入操作指南中的修改文档部分。

插入多个文档

下一步

更新多个文档