laravel 查询构建器高级用法包括子查询嵌套、条件式查询（when/unless）、原生表达式（selectRaw/whereRaw）、批量操作（insertOrIgnore/upsert），核心在于组合性与延迟执行。
Laravel 的查询构建器（Query Builder）是 Eloquent 之外最常用、最灵活的数据操作方式，它直接基于 数据库 连接工作，不依赖模型，执行效率高，适合复杂查询、聚合统计、多表联合或原生 sql 增强场景。掌握它的高级用法，能显著提升开发效率和 SQL 控制力。
子查询（Subquery）嵌套与动态构造
子查询常用于 WHERE、FROM 或 SELECT 中，Laravel 允许将整个查询构建器实例作为参数传入，自动编译为括号包裹的子语句。
- 在 WHERE 中使用子查询判断：比如查出“订单金额高于该用户平均订单金额”的订单
DB::table(‘orders’)->where(‘amount’, ‘>’, function ($query) {
$query->selectRaw(‘AVG(amount)’)
->from(‘orders as o2’)
->whereColumn(‘o2.user_id’, ‘orders.user_id’);
});
- 在 FROM 中使用子查询（派生表）：对聚合结果再筛选
DB::table(DB::raw(‘(SELECT user_id, COUNT(*) as cnt FROM orders GROUP BY user_id HAVING cnt > 5) as top_users’))
->join(‘users’, ‘users.id’, ‘=’, ‘top_users.user_id’)
->select(‘users.name’, ‘top_users.cnt’);
条件式查询（Conditional Clauses）避免 if 分支污染
使用 when() 和 unless() 可让查询逻辑更声明式，只在条件满足时追加 where / join / orderBy 等子句，无需手动拼接或空判断。
- when 接收布尔值或 闭包，true 时执行第二个参数的闭包（接收 builder 实例）
$status = request(‘status’);
$search = request(‘q’);
DB::table(‘posts’)
->when($status, function ($query, $status) {
return $query->where(‘status’, $status);
})
->when($search, function ($query, $search) {
return $query->where(‘title’, ‘like’, “%{$search}%”)
->orWhere(‘content’, ‘like’, “%{$search}%”);
})
->get();
- unless 是 when 的反向逻辑，适合“除非为空才过滤”这类场景
原生表达式与高级 聚合函数
selectRaw、whereRaw、havingRaw 等方法可插入原生 SQL 片段，配合 DB::raw() 实现时间处理、jsON 操作、窗口函数等高级能力（需数据库支持）。
- 按周 / 月分组统计（mysql 示例）
DB::table(‘orders’)
->selectRaw(‘YEAR(created_at) as year, MONTH(created_at) as month, count(*) as total’)
->groupBy(‘year’, ‘month’)
->orderBy(‘year’, ‘desc’)
->orderBy(‘month’, ‘desc’)
->get();
DB::table(‘users’)
->whereRaw(‘JSON_CONTAINS(preferences, ?)’, [‘{“theme”: “dark”}’])
->get();
- 使用 DB::raw() 绕过自动转义，例如调用 NOW()、CONCAT、COALESCE
->select(‘id’, DB::raw(‘CONCAT(first_name, ” “, last_name) as full_name’))
批量操作与 UPSERT（insertOrIgnore / upsert）
针对大量数据写入，避免 N+1 循环 插入；Laravel 9+ 提供了更安全的 upsert 支持（MySQL 8.0.19+/postgresql），自动处理冲突并更新指定字段。
- 批量插入（忽略重复主键 / 唯一键错误）
DB::table(‘products’)->insertOrIgnore([
[‘id’ => 1, ‘name’ => ‘Laptop’],
[‘id’ => 2, ‘name’ => ‘Mouse’],
]);
- upsert：存在则更新，不存在则插入（指定唯一索引列 + 更新字段）
DB::table(‘flights’)->upsert(
[
[‘departure’ => ‘Oakland’, ‘destination’ => ‘San Diego‘, ‘price’ => 99],
[‘departure’ => ‘Chicago’, ‘destination’ => ‘New York’, ‘price’ => 150],
],
[‘departure’, ‘destination’], // 唯一匹配字段
[‘price’] // 冲突时更新这些字段
);
基本上就这些。Query Builder 的高级用法核心在于“组合性”与“延迟执行”——所有方法都返回 builder 实例，可链式拼装；SQL 直到 get()/first()/update() 才真正执行。合理使用子查询、条件式构造、原生表达式和批量操作，既能写出清晰可维护的代码，又能贴近数据库能力边界。
