Laravel执行SQL如何分页查询-php教程-PHP中文网

db::select()无法直接分页，需手动查总数与当前页数据并用lengthawarepaginator构造分页器；复杂sql分页应拆分为两次查询，避免offset性能问题，游标分页需自行实现。

laravel执行sql如何分页查询

用 `DB::select()` 手动查 SQL 时没法直接分页

因为 DB::select() 返回的是纯数组，不带 LengthAwarePaginator 或 CursorPaginator 的能力。你拿到结果后，得自己算偏移、自己截数组、自己塞总数——容易漏总数、错页码、不兼容前端传来的 page 和 per_page 参数。

常见错误现象：DB::select("SELECT * FROM users WHERE status = ?", [$status]) 后硬套 array_slice()，但没查总条数，导致分页器显示“共 0 页”或跳转异常。

如果 SQL 简单（无子查询、无 UNION），优先改用 Eloquent 或 Query Builder 的链式分页
如果必须手写复杂 SQL（比如含窗口函数、多层嵌套），就用 DB::select() + 手动构造分页器，但务必单独执行一次 COUNT(*) 查询
注意：MySQL 8+ 的 ROW_NUMBER() 不适合直接分页，它不等价于 LIMIT/OFFSET，且无法跳过中间页

复杂 SQL 分页的正确姿势：两次查询 + `LengthAwarePaginator`

核心是把「查数据」和「查总数」拆开，再用原生结果喂给 Laravel 分页器。别试图在一条 SQL 里塞 LIMIT 和 COUNT(*) —— 大多数场景下它们的 WHERE 条件一致，但执行计划可能完全不同，强行合并反而慢。

示例：分页查带用户等级统计的订单报表

// 1. 先查总数（只 SELECT COUNT(*)，去掉所有字段和 ORDER BY）
$total = DB::select("SELECT COUNT(*) as cnt FROM orders o JOIN users u ON o.user_id = u.id WHERE u.level > ?", [2])[0]->cnt;
<p>// 2. 再查当前页数据（带 LIMIT 和 OFFSET）
$offset = ($page - 1) * $perPage;
$records = DB::select("SELECT o.id, o.amount, u.name FROM orders o JOIN users u ON o.user_id = u.id WHERE u.level > ? ORDER BY o.created_at DESC LIMIT ? OFFSET ?", [2, $perPage, $offset]);</p><p>// 3. 手动构建分页器（注意：第三个参数是当前页码，不是 offset）
$paginator = new LengthAwarePaginator($records, $total, $perPage, $page, [
'path' => request()->url(),
'query' => request()->query(),
]);</p>

务必检查 $page 是否为正整数，否则 LengthAwarePaginator 构造会报错
OFFSET 在大数据量时性能差（比如 offset 100000），此时应考虑游标分页或优化索引
如果 SQL 含 GROUP BY 或聚合，COUNT(*) 必须对应重写为 COUNT(DISTINCT ...)，否则总数不准

想保留 Query Builder 语法又绕不开复杂 SQL？用 `DB::table()->fromRaw()`

当 SQL 太长、含变量拼接但又不想全手写字符串时，可以用 fromRaw() 把子查询当表用，再套上 paginate() —— 这样能复用 Laravel 的分页逻辑，包括自动处理 ?page=2、生成链接、响应 JSON 格式。

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

示例：把带条件聚合的子查询作为主表分页

$paginator = DB::table(DB::raw("(SELECT user_id, COUNT(*) as order_count FROM orders WHERE created_at > '2024-01-01' GROUP BY user_id HAVING COUNT(*) >= 3) as t"))
    ->join('users', 't.user_id', '=', 'users.id')
    ->select('users.name', 't.order_count')
    ->paginate(15);