laravel Eloquent ORM通过模型类操作数据库,支持all()、find()、where()等方法进行数据查询,可链式调用条件、排序与分页,结合作用域复用逻辑,并通过关联关系实现一对一、一对多等查询,使用with预加载优化性能。
Laravel 的 Eloquent ORM 提供了简洁且强大的方式来操作数据库。它将数据库表映射为模型类,让你可以用面向对象的方式进行查询和数据操作。以下是常用 Eloquent 查询方法的使用说明,帮助你快速上手。
基本查询方法
Eloquent 模型默认继承自 IlluminatedatabaseEloquentModel,支持多种链式调用的查询构造器方法。
- all():获取模型对应表的所有记录
- find($id):根据主键查找单条记录
- findOrFail($id):查不到时抛出 404 异常
- first():返回满足条件的第一条记录
- firstOrFail():未找到时抛出异常
- get():执行查询并返回结果集合
- count()、sum()、max() 等聚合函数
示例:
// 获取所有用户 $users = User::all(); // 查找 ID 为 1 的用户 $user = User::find(1); // 获取状态为启用的用户数量 $count = User::where('status', 1)->count();
条件查询与链式操作
你可以使用 where 方法添加查询条件,并通过链式调用组合多个条件。
- where('column', 'value') 或 where('column', '>', value)
- whereIn('column', [values]):匹配字段值在指定数组中
- whereNull('column') 和 whereNotNull('column')
- orderBy('column', 'asc|desc'):排序
- skip($number)->take($number):分页或限制结果数量
示例:
$users = User::where('status', 1) ->whereIn('type', [1, 2]) ->whereNotNull('email_verified_at') ->orderBy('created_at', 'desc') ->skip(0)->take(10) ->get();
作用域(Scopes)复用查询逻辑
通过定义本地作用域,可以封装常用的查询条件,提升代码可读性和复用性。
在模型中定义以 scope 开头的方法:
class User extends Model { public function scopeActive($query) { return $query->where('status', 1); } public function scopeType($query, $type) { return $query->where('type', $type); } }
调用作用域:
$activeUsers = User::active()->get(); $adminUsers = User::active()->type(2)->get();
关联查询(Relationships)
Eloquent 支持定义模型之间的关系,如一对一、一对多、多对多等。
- hasOne、belongsTo:一对一
- hasMany、belongsTo:一对多
- belongsToMany:多对多
定义关系后,可以直接访问关联数据:
// 在 User 模型中定义 public function posts() { return $this->hasMany(Post::class); } // 使用 $user = User::find(1); $posts = $user->posts; // 获取该用户所有文章
也可以用 with 进行预加载,避免 N+1 查询问题:
$users = User::with('posts')->get();
基本上就这些。掌握这些核心方法后,你可以高效地使用 Eloquent 实现各种数据库操作,同时保持代码清晰易维护。