登录
首页 >  文章 >  php教程

Laravel如何使用Eloquent模型_Laravel使用Eloquent模型方法【ORM】

时间:2026-05-04 13:36:58 175浏览 收藏

最近发现不少小伙伴都对文章很感兴趣,所以今天继续给大家介绍文章相关的知识,本文《Laravel如何使用Eloquent模型_Laravel使用Eloquent模型方法【ORM】》主要内容涉及到等等知识点,希望能帮到你!当然如果阅读本文时存在不同想法,可以在评论中表达,但是请勿使用过激的措辞~

Laravel中正确使用Eloquent需:一、创建模型并配置$table、$primaryKey、$fillable;二、用all()、find()、first()、findOrFail()、get()执行查询;三、通过new+save、create或forceCreate插入数据;四、用实例save、update或where+update更新;五、用delete、destroy或where+delete删除。

Laravel如何使用Eloquent模型_Laravel使用Eloquent模型方法【ORM】

如果您在 Laravel 项目中需要与数据库交互,但尚未正确配置或调用 Eloquent 模型,则可能导致查询失败、数据无法写入或关联加载异常。以下是使用 Eloquent 模型的具体方法:

一、创建并配置模型类

模型是 Eloquent 操作数据库的入口,必须继承 Illuminate\Database\Eloquent\Model,且需遵循命名与表名约定或显式声明映射关系。未正确声明 $table、$fillable 或主键可能导致批量赋值拒绝、查询定位错误或时间戳异常。

1、在终端执行 Artisan 命令生成模型文件:php artisan make:model User

2、打开生成的 app/Models/User.php,确认类继承自 Model,并根据实际表结构调整属性:

3、若数据库表名为 my_users(非默认复数形式),需显式设置:protected $table = 'my_users';

4、若主键字段为 user_id 而非 id,添加:protected $primaryKey = 'user_id';

5、若需允许批量赋值(如 create() 方法),定义可填充字段:protected $fillable = ['name', 'email', 'password'];

二、执行基础查询操作

Eloquent 提供多种静态方法获取数据,不同方法返回类型与异常处理机制不同,误用可能导致空对象访问或静默失败。

1、获取全部记录:User::all(),返回 Illuminate\Database\Eloquent\Collection 实例。

2、按主键查找单条记录:User::find(1),查无结果时返回 null

3、按条件查找首条匹配记录:User::where('email', 'test@example.com')->first()

4、查无结果时抛出 404 异常:User::findOrFail(1),适用于路由模型绑定场景。

5、按条件获取多条记录:User::where('active', 1)->get(),返回集合,支持链式调用如 orderBy、limit。

三、插入新数据

插入方式分为实例化后保存与批量创建两类,区别在于是否触发模型事件(如 creating、created)及是否校验 $fillable 配置。

1、实例化后逐字段赋值并保存:$user = new User; $user->name = 'Tom'; $user->email = 'tom@example.com'; $user->save();

2、使用 create() 批量赋值:User::create(['name' => 'Jerry', 'email' => 'jerry@example.com']);,要求字段已在 $fillable 中声明。

3、若需跳过 $fillable 检查而强制插入,改用 forceCreate():User::forceCreate(['name' => 'Admin', 'email' => 'admin@local']);

四、更新已有记录

更新操作存在实例更新与静态批量更新两种路径,前者触发模型事件和访问器/修改器,后者绕过模型生命周期且不验证字段合法性。

1、先查后改再保存:$user = User::find(1); $user->name = 'Updated Name'; $user->save();

2、使用 update() 静态方法批量更新:User::where('id', 1)->update(['name' => 'New Name']);

3、对已加载模型实例调用 update():$user->update(['email' => 'new@example.com']);,此方式仍触发事件。

4、若需更新多个字段且避免 N+1 查询,推荐结合 where + update,而非遍历模型集合逐个 save。

五、删除数据记录

删除行为分软删除与硬删除,Eloquent 默认执行硬删除;启用软删除需引入 SoftDeletes trait 并迁移添加 deleted_at 字段。

1、通过模型实例删除:$user = User::find(1); $user->delete();

2、使用 destroy() 静态方法按主键删除:User::destroy(1);,支持传入多个 ID:User::destroy([1, 2, 3]);

3、按条件批量删除:User::where('created_at', 'subDays(30))->delete();

4、启用软删除后,上述 delete() 和 destroy() 不真正移除数据,仅设置 deleted_at 时间戳;查询时自动排除已软删除记录,除非显式调用 withTrashed() 或 onlyTrashed()。

今天关于《Laravel如何使用Eloquent模型_Laravel使用Eloquent模型方法【ORM】》的内容就介绍到这里了,是不是学起来一目了然!想要了解更多关于的内容请关注golang学习网公众号!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>