1. 转换原生SQL到Laravel查询构建器的必要性
在laravel开发中，尽管原生sql查询提供了最大的灵活性，但它往往缺乏框架提供的便利性，尤其是在处理数据分页、参数绑定和代码可读性方面。将原生sql转换为laravel的查询构建器，能够带来以下显著优势：
- 提升可读性和可维护性： 查询构建器使用链式调用，代码结构更清晰，易于理解和修改。
- 增强安全性： 查询构建器会自动处理参数绑定，有效防止SQL注入攻击。
- 方便集成框架功能： 轻松使用Laravel提供的分页（paginate()）、软删除、模型事件等高级功能。
- 跨数据库兼容性： 查询构建器抽象了底层数据库差异，使得代码在不同数据库之间迁移更为便捷。
对于需要处理大量数据且需要分页的复杂查询，转换到查询构建器是提升开发效率和应用性能的关键一步。
2. 核心转换策略：DB::raw()与joinSub()的应用
面对包含子查询、聚合函数和条件逻辑的复杂原生SQL，Laravel查询构建器提供了DB::raw()和joinSub()两个强大工具来应对。
- DB::raw()： 当查询构建器没有直接对应的方法来表达特定的SQL函数或复杂表达式时，可以使用DB::raw()来插入原生的SQL片段。这对于聚合函数（如MIN, COUNT, SUM）、条件表达式（如IF语句）以及其他数据库特定函数尤为有用。
- joinSub()： 该方法允许你将一个完整的查询构建器实例作为子查询加入到主查询中，并像普通表一样进行连接操作。这对于需要预先聚合或筛选数据，然后与主表连接的场景非常适用。
3. 实例解析：复杂查询的转换过程
我们以一个具体的复杂查询为例，演示如何将其转换为Laravel查询构建器。原始查询涉及两个表cp_counsel和cp_cases_counsel，包含子查询、多个聚合函数、条件聚合以及分组操作，并最终需要分页。
原始SQL逻辑分析：
- 子查询 cpCounsel： 从cp_counsel表中选择enrolment_number作为id，并获取每个enrolment_number对应的最小counsel值，然后按enrolment_number分组。
-
主查询 counsels：
- 从cp_cases_counsel表开始。
- 将子查询cpCounsel作为别名A连接进来，连接条件是A.id = T.counsel_id。
- 根据A.counsel进行模糊搜索。
- 选择counsel_id、counsel，并计算多项聚合数据，包括总数、最高法院案件数（按角色区分）、上诉法院案件数（按角色区分）。这些聚合涉及到COUNT和SUM与IF条件判断的结合。
- 按T.counsel_id和A.counsel分组。
- 最后对结果进行分页。
转换为Laravel查询构建器：
search_term 已经定义
/**
* 步骤1：构建子查询 (cpCounsel)
* 对应 SQL:
* SELECT A.enrolment_number AS id, MIN(A.counsel) AS counsel
* FROM cp_counsel AS A
* GROUP BY enrolment_number
*/
$cpCounsel = DB::table('cp_counsel as A')
->select([
'A.enrolment_number as id',
DB::raw('MIN(A.counsel) as counsel'), // 使用 DB::raw() 处理 MIN 函数
])
->groupBy('enrolment_number');
/**
* 步骤2：构建主查询 (counsels)
* 对应 SQL:
* SELECT T.counsel_id, A.counsel, COUNT(T.counsel_id) AS total,
* SUM(IF(T.court_id = 2, 1, 0)) AS supreme_court_cases,
* ... (其他条件聚合)
* FROM cp_cases_counsel AS T
* JOIN ({子查询}) AS A ON A.id = T.counsel_id
* WHERE A.counsel LIKE '%search_term%'
* GROUP BY T.counsel_id, A.counsel
*/
$counsels = DB::table('cp_cases_counsel as T')
// 使用 joinSub() 将子查询作为虚拟表 A 连接
->joinSub($cpCounsel, 'A', function ($join) {
$join->on('A.id', '=', 'T.counsel_id');
})
// 添加 where 条件
->where('A.counsel', 'like', "%{$request->search_term}%")
->select([
'T.counsel_id',
'A.counsel',
DB::raw('COUNT(T.counsel_id) as total'), // 总数聚合
// 最高法院案件数及其角色区分的条件聚合
DB::raw('SUM(if(T.court_id = 2, 1, 0)) as supreme_court_cases'),
DB::raw('SUM(if(T.court_id = 2, 1, 0) AND if(T.counsel_role = 1, 1, 0)) as supreme_court_cases_as_lead'),
DB::raw('SUM(if(T.court_id = 2, 1, 0) AND if(T.counsel_role = 2, 1, 0)) as supreme_court_cases_as_supporting'),
// 上诉法院案件数及其角色区分的条件聚合
DB::raw('SUM(if(T.court_id = 1, 1, 0)) as appeal_court_cases'),
DB::raw('SUM(if(T.court_id = 1, 1, 0) AND if(T.counsel_role = 1, 1, 0)) as appeal_court_cases_as_lead'),
DB::raw('SUM(if(T.court_id = 1, 1, 0) AND if(T.counsel_role = 2, 1, 0)) as appeal_court_cases_as_supporting'),
])
// 分组
->groupBy('T.counsel_id', 'A.counsel')
// 实现分页
->paginate(15);
// $counsels 现在是一个 Illuminate\Pagination\LengthAwarePaginator 实例
// 你可以直接在视图中使用它来渲染分页链接和数据4. 注意事项与最佳实践
- 何时使用DB::raw()： 仅当查询构建器没有直接对应的方法时才使用DB::raw()。过度使用DB::raw()会降低代码的可读性，并可能丧失查询构建器提供的一些安全性检查。例如，简单的COUNT(*)可以直接用->count()，而不需要DB::raw('COUNT(*)')。
- 性能考量： 尽管查询构建器有助于构建复杂查询，但查询本身的性能仍然取决于SQL的优化。对于非常大的数据集，确保表有正确的索引，并考虑数据库层面的优化。
- 可读性与复杂性平衡： 对于极其复杂的聚合逻辑，有时将其分解为多个较简单的查询或视图，然后再进行连接，可能会提高可读性和调试效率。
-
调试查询： 在开发过程中，可以使用toSql()方法查看查询构建器生成的原生SQL，或者使用dd()打印查询结果，这对于调试非常有用。
// 查看生成的 SQL 语句 dd($counsels->toSql()); // 查看绑定参数 dd($counsels->getBindings());
- Eloquent ORM： 对于更面向对象的开发，如果你的表有对应的Eloquent模型，可以考虑使用Eloquent关系和集合方法来处理数据。然而，对于这种包含大量聚合和子查询的复杂报表类查询，查询构建器通常是更直接和高效的选择。
5. 总结
通过本教程，我们了解了如何将复杂原生SQL查询转换为Laravel查询构建器。核心在于灵活运用DB::raw()来嵌入原生SQL片段，以及使用joinSub()来处理子查询。这种转换不仅提升了代码的清晰度、可维护性和安全性，更重要的是，它使得Laravel强大的分页功能能够无缝地应用于这些复杂的查询结果，从而有效管理和展示大量数据。掌握这些技巧，将极大地提高你在Laravel中处理数据库操作的能力。
