首先使用查询构造器构造sql并手动计算分页参数,再通过LengthAwarePaginator实现分页显示,最后可封装为服务复用或结合原生SQL处理复杂查询。
如果您需要在 laravel 中执行数据库查询并实现分页功能,但不想使用 Eloquent ORM,可以直接利用查询构造器配合手动分页逻辑来完成。这种情况常见于复杂查询或性能敏感的场景。
本文运行环境:macBook Pro,macOS Sonoma
一、使用查询构造器与 Paginator 手动分页
Laravel 的查询构造器可以脱离模型直接操作数据库表,结合 IlluminatePaginationPaginator 类可实现分页控制。此方法允许您完全掌控 SQL 查询结构和分页参数。
1、在控制器中引入 DB 门面和 Paginator 类:use IlluminateSupportFacadesDB; 和 use IlluminatePaginationLengthAwarePaginator;。
2、使用 DB::table() 构造原始查询语句,例如:$results = DB::table(‘users’)->where(‘status’, 1)->get();。
3、获取当前页码,通常从请求中读取:$currentPage = request()->input(‘page’, 1);。
4、设定每页显示条数,如 $perPage = 10,并计算偏移量:$offset = ($currentPage – 1) * $perPage;。
5、重新执行带 limit 和 offset 的查询:DB::table(‘users’)->where(‘status’, 1)->skip($offset)->take($perPage)->get();。
6、创建 LengthAwarePaginator 实例,传入数据、总记录数、每页数量和当前页码,确保生成正确的分页链接。
二、封装为可复用的分页服务
将上述分页流程封装成独立的服务类或辅助函数,有助于在多个控制器中重复使用,提升代码整洁度和维护性。
1、创建一个名为 CustomPaginatorService 的类,并定义一个接受查询构建器、每页数量和当前页码的方法。
2、在服务类内部自动处理 skip、take 操作,并通过 count 查询获取总数。
3、返回一个 LengthAwarePaginator 对象,其包含当前页数据、总条目数、每页大小及当前页码。
4、在控制器中调用该服务,传入 DB::table(‘xxx’) 查询实例即可获得分页结果。
5、确保服务支持动态 WHERE 条件传递,例如以闭包形式接收额外查询条件。
三、结合原生 SQL 与分页处理器
当查询过于复杂无法用查询构造器表达时,可使用 DB::select 执行原生 SQL,但仍可通过手动分页机制集成 Laravel 分页外观。
1、使用 DB::select 执行包含 JOIN、子查询等复杂逻辑的 SQL 语句,获取全部结果集用于计数。
2、另写一条带 LIMIT 和 OFFSET 的版本用于获取当前页数据,注意防止 SQL 注入,务必使用参数绑定。
3、通过 DB::select(‘SELECT COUNT(*) as count FROM (…) AS sub’, [$bindings]) 获取总行数。
4、提取当前页数据后,使用相同方式构建 LengthAwarePaginator 实例。
5、将最终分页对象传递给视图,在 Blade 模板中使用 links() 方法渲染分页导航。