php firstorfail,Laravel中firstOrCreate与firstOrNew及firstOrFail的区别

官方文档：

https://learnku.com/docs/laravel/6.x/eloquent/5176#b438f8

在日常开发的过程中，经常会遇到判断一条记录是否存在、存在更新、不存在新建记录这种场景，在 Laravel 中提供了方法支持，那么下面就看下具体的方法；

使用时请注意版本，下面介绍的函数 firstOrCreate 和 firstOrNew firstOrFail中使用

1、firstOrCreate

如果查询结果不存在，则会以后边的两个参数为基础，创建新的实例Model返回，并且将数据查询到数据中小于 5.5 版本，只有一个参数

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();

});

}

2、firstOrNew

如果查询的结果不存在，则会以 firstOrNew中传递的两个参数为基础，创建一个新的Model 实例返回，并不会保存到数据库中

小于 5.5 版本，只有一个参数

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 方法，两个方法都很实用，根据场景使用它。

2.firstOrNew

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

用法：

User::firstOrNew(['name' => 'Lisi']);

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

3、firstOrFail

如果查询的方法不存在，则抛出一个异常信息

项目中用法：$doctorLevel = DoctorModel::query()->with([

'level' => function ($query) {

$query->select('id', 'level_name');

}

])->where('id','339856447067199853')->select(['id', 'doctor_level'])->firstOrFail();

返回结果:

"message": "No query results for model [App\\Models\\Inquiry\\DoctorModel].",

Laravel firstOrNew 与 firstOrCreate 的区别

例如：

$item = App\Deployment::firstOrNew(

['name' => '问答小程序'], ['delayed' => 1]

);

firstOrNew 需要手动调用 save，才会保存到数据库。适合同时需要修改其他属性的场景。

firstOrCreate 会自动保存到数据库。适合不需要额外修改其他属性的场景。

注意：MassAssignmentException

firstOrCreate 一定要设置 model 的 fillable, 否则会报 MassAssignmentException 的错误。

参考： Laravel Model 的 fillable (白名单)与 guarded (黑名单)

即，create 受 fillable 的限制，但是 save 不受影响。

用法：User::firstOrCreate(['name' => 'Lisi']);

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

官方文档：

https://learnku.com/docs/laravel/6.x/eloquent/5176#b438f8