0

0

laravel Eloquent的updateOrCreate和firstOrCreate有什么区别_laravel Eloquent updateOrCreate与firstOrCreate区别解析

尼克

尼克

发布时间:2025-11-08 14:57:03

|

996人浏览过

|

来源于php中文网

原创

updateOrCreate会更新或创建记录,firstOrCreate仅创建不存在的记录。前者匹配时更新指定字段,后者直接返回已有数据,适用于确保唯一性或初始化场景。

laravel eloquent的updateorcreate和firstorcreate有什么区别_laravel eloquent updateorcreate与firstorcreate区别解析

如果您在使用 Laravel 的 Eloquent 模型进行数据操作时,发现需要根据条件判断记录是否存在并执行更新或创建逻辑,则可能会用到 updateOrCreate 和 firstOrCreate 方法。这两个方法虽然都用于处理“查找或操作”的场景,但其行为和用途有明显差异。

本文运行环境:MacBook Pro,macOS Sonoma

一、updateOrCreate 的作用与使用方式

updateOrCreate 用于尝试根据指定的查找条件更新一条记录,如果该记录不存在,则会使用给定的数据创建一条新记录。该方法会直接对数据库执行写操作,无论结果是更新还是插入。

1、调用 updateOrCreate 时需传入两个参数数组:第一个是用于查找的字段条件,第二个是需要更新或写入的字段值。

2、Eloquent 会先执行 SELECT 查询,检查是否已有满足条件的记录。

3、若存在匹配记录,则执行 UPDATE 操作,仅更新第二个数组中指定的字段。

4、若无匹配记录,则执行 INSERT 操作,将两个数组合并后的数据作为新记录插入数据库。

5、该方法返回的是已更新或新创建的模型实例。

注意:即使只更新部分字段,也必须在第二个参数中明确列出所有要写入的字段

二、firstOrCreate 的作用与使用方式

firstOrCreate 用于根据指定条件查找一条记录,如果找不到则使用提供的数据创建一条新记录。与 updateOrCreate 不同,它不会对已有记录进行字段更新,仅用于确保某条记录存在。

1、调用 firstOrCreate 时同样接收两个数组参数:第一个为查找条件,第二个为创建时填充的额外字段。

蝉镜
蝉镜

AI数字人视频创作平台,100+精品数字人形象库任您选择

下载

2、Eloquent 首先执行 SELECT 查询,判断是否存在符合查找条件的记录。

3、若记录存在,则直接返回该模型实例,不会对现有数据做任何修改

4、若记录不存在,则将两个数组合并后插入数据库,并返回新建的模型实例。

5、此方法适用于确保唯一性记录存在,例如初始化配置项或用户默认设置。

三、关键区别对比

两者最核心的区别在于对已有记录的处理策略:updateOrCreate 会对已有记录执行更新操作,而 firstOrCreate 在记录存在时不做任何更改。

1、当查找条件匹配到已有数据时,updateOrCreate 会强制更新第二个参数中的字段值。

2、firstOrCreate 在查找到记录后直接返回,完全跳过更新逻辑,保证原有数据不被覆盖。

3、若希望在记录存在时保留原始数据,则应选择 firstOrCreate。

4、若需要每次调用都同步最新数据(如状态刷新),则 updateOrCreate 更合适。

5、两个方法均基于原子性查询实现,避免了常见的“先查后插”导致的并发问题。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

313

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

270

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

362

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

362

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

80

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

63

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

62

2025.08.05

macOS怎么切换用户账户
macOS怎么切换用户账户

在 macOS 系统中,可通过多种方式切换用户账户。如点击苹果图标选择 “系统偏好设置”,打开 “用户与群组” 进行切换;或启用快速用户切换功能,通过菜单栏或控制中心的账户名称切换;还能使用快捷键 “Control+Command+Q” 锁定屏幕后切换。

322

2025.05.09

ip地址修改教程大全
ip地址修改教程大全

本专题整合了ip地址修改教程大全,阅读下面的文章自行寻找合适的解决教程。

27

2025.12.26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

PHP自制框架
PHP自制框架

共8课时 | 0.6万人学习

PHP面向对象基础课程(更新中)
PHP面向对象基础课程(更新中)

共12课时 | 0.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号