Laravel Eloquent的firstOrCreate和firstOrNew有什么区别-Laravel-PHP中文网

Laravel Eloquent的firstOrCreate和firstOrNew有什么区别

冰火之心

发布： 2025-11-17 12:27:05

原创

123人浏览过

firstOrCreate查不到则自动插入并返回已保存实例，firstOrNew查不到仅返回新实例需手动save；前者适合直接创建，后者便于创建前做额外处理。

laravel eloquent的firstorcreate和firstornew有什么区别

firstOrCreate 和 firstOrNew 都是 Laravel Eloquent 提供的便捷方法，用于根据条件查找模型，如果找不到则进行创建或返回新实例。虽然功能相似，但它们的行为有关键区别。

1. firstOrCreate：查找或直接插入数据库

该方法会：

魔乐社区

天翼云和华为联合打造的AI开发者社区，支持AI模型评测训练、全流程开发应用

102

查看详情

• 先在数据库中查找是否已有满足条件的记录。
• 如果没有找到，就会自动将数据插入数据库，并返回这个已保存的模型实例。
• 第一个参数是查询条件（数组），第二个参数（可选）是需要填充但不参与查询的字段。

示例：

$user = User::firstOrCreate(
['email' => 'john@example.com'],
['name' => 'John', 'age' => 25]
);

说明：如果 email 为 john@example.com 的用户不存在，Eloquent 会立即插入一条新记录到数据库。

2. firstOrNew：查找或返回新模型实例（不自动保存）

该方法会：

• 同样先查找符合条件的记录。
• 如果没找到，就返回一个新的模型实例，但不会自动保存到数据库。
• 是否保存，由你后续手动调用 save() 决定。

示例：

$user = User::firstOrNew(['email' => 'john@example.com']);
if ($user->exists) {
   // 已存在，可以直接使用
} else {
   $user->name = 'John';
   $user->age = 25;
   $user->save(); // 手动保存
}

说明：firstOrNew 返回的对象可能未持久化，需判断 $user->exists 或手动调用 save() 来写入数据库。

核心区别总结

• 自动保存：firstOrCreate 自动写入数据库；firstOrNew 不会，需手动 save()。
• 使用场景：若希望“查不到就创建并保存”，用 firstOrCreate；若想在创建前做额外处理（如验证、赋值），用 firstOrNew 更灵活。
• 性能考虑：firstOrCreate 是原子操作，适合简单场景；firstOrNew 给你更多控制权。

基本上就这些。选择哪个取决于你是否需要在保存前干预模型状态。

以上就是Laravel Eloquent的firstOrCreate和firstOrNew有什么区别的详细内容，更多请关注php中文网其它相关文章！