firstOrCreate、firstOrNew、updateOrCreate

最新推荐文章于 2025-07-06 10:29:40 发布

转载最新推荐文章于 2025-07-06 10:29:40 发布 · 1.4k 阅读

laravel 专栏收录该内容

10 篇文章

订阅专栏

本文深入探讨了Laravel框架中Eloquent ORM的三个核心方法：firstOrCreate, firstOrNew和updateOrCreate。详细解释了这些方法如何在数据库操作中高效地查找、创建或更新记录，特别强调了不同版本之间的差异。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

firstOrCreate

firstOrCreate 方法将会使用指定的字段 => 值对，来尝试寻找数据库中的记录。如果在数据库中找不到，5.3 以下版本会使用属性来添加一条记录，5.3 及以上版本则将使用第一个参数中的属性以及可选的第二个参数中的属性插入记录

User::firstOrCreate(['name' => 'Lisi']);
User::firstOrCreate(['name' => 'Lisi'], ['age' => 20]);  // 5.3及以上版本支持

# 小于 5.3 版本，只有一个参数
public function firstOrCreate(array $attributes)
{
    if (! is_null($instance = $this->where($attributes)->first())) {
        return $instance;
    }
    $instance = $this->model->newInstance($attributes);
    $instance->save();
    return $instance;
}

# 5.5 版本
public function firstOrCreate(array $attributes, array $values = [])
{
    // 判断是否存在,如果存在,返回实例
    if (! is_null($instance = $this->where($attributes)->first())) {
        return $instance;
    }

    // 不存在创建，此代码简化就是 $this->newModelInstance($attributes + $values)->save();
    return tap($this->newModelInstance($attributes + $values), function ($instance) {
        $instance->save();
    });
}

firstOrNew

会尝试使用指定的属性在数据库中寻找符合的纪录。如果未被找到，将会返回一个新的模型实例。请注意 firstOrnew返回的模型还尚未保存到数据库。你需要通过手动调用 save 方法来保存它

User::firstOrNew(['name' => 'Lisi']); // 5.4 以下版本
User::firstOrNew(['name' => 'Lisi'], ['age' => 20]); // 5.4及以上版本支持

# 小于 5.4 版本，只有一个参数
public function firstOrNew(array $attributes)
{
    if (! is_null($instance = $this->where($attributes)->first())) {
        return $instance;
    }
    return $this->model->newInstance($attributes);
}

# 5.5 版本
public function firstOrNew(array $attributes, array $values = [])
{
    if (! is_null($instance = $this->where($attributes)->first())) {
        return $instance;
    }
    return $this->newModelInstance($attributes + $values);
}

查看源码就更清楚 firstOrCreate 比 firstOrNew 多了 save 方法，两个方法都很实用，根据场景使用它。

updateOrCreate

更新数据，如果不存在则创建，这个函数就充分利用到了方法 firstOrNew，此函数版本之间变化不大

User::updateOrCreate(['name' => 'Lisi'], ['age' => 20]);

# 5.5 版本
public function updateOrCreate(array $attributes, array $values = [])
{
    return tap($this->firstOrNew($attributes), function ($instance) use ($values) {
        $instance->fill($values)->save();
    });
}