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 时同样接收两个数组参数:第一个为查找条件,第二个为创建时填充的额外字段。
2、Eloquent 首先执行 SELECT 查询,判断是否存在符合查找条件的记录。
3、若记录存在,则直接返回该模型实例,不会对现有数据做任何修改。
4、若记录不存在,则将两个数组合并后插入数据库,并返回新建的模型实例。
5、此方法适用于确保唯一性记录存在,例如初始化配置项或用户默认设置。
三、关键区别对比
两者最核心的区别在于对已有记录的处理策略:updateOrCreate 会对已有记录执行更新操作,而 firstOrCreate 在记录存在时不做任何更改。
1、当查找条件匹配到已有数据时,updateOrCreate 会强制更新第二个参数中的字段值。
2、firstOrCreate 在查找到记录后直接返回,完全跳过更新逻辑,保证原有数据不被覆盖。
3、若希望在记录存在时保留原始数据,则应选择 firstOrCreate。
4、若需要每次调用都同步最新数据(如状态刷新),则 updateOrCreate 更合适。