Laravel中自定义字符串SQL查询的分页实现问题

嘿，我刚好碰到过和你一模一样的场景——数据库存着重要的原生SQL字符串，没法用关联关系，只能用DB::select()执行，还要做分页。给你分享几个靠谱的实现方法：

方案一：手动构建LengthAwarePaginator（推荐） #

Laravel的分页核心是LengthAwarePaginator类，它支持手动传入数据、总条数、每页数量等参数，刚好适配我们的场景。步骤如下：

1. 获取总数据条数
   首先得知道查询结果的总条数，这样分页器才能计算总页数。这里有两种安全的方式：

   • 如果你确定原SQL没有复杂的分组或子查询，可以用正则替换原SQL的SELECT部分为COUNT(*)：

     $sql = $table->query;
     // 替换SELECT ... FROM为SELECT COUNT(*) AS total FROM
     $countSql = preg_replace('/SELECT.*?FROM/i', 'SELECT COUNT(*) AS total FROM', $sql);
     $total = DB::selectOne($countSql)->total;
     

   • 如果原SQL比较复杂（比如带GROUP BY、子查询），更稳妥的方式是把原SQL作为子查询：

     $countSql = "SELECT COUNT(*) AS total FROM ($sql) AS subquery";
     $total = DB::selectOne($countSql)->total;
     

2. 获取当前页的数据
   计算偏移量，给原SQL加上LIMIT和OFFSET：

   $page = request()->get('page', 1); // 当前页码，默认1
   $perPage = 15; // 每页显示条数，可根据需求调整
   
   $offset = ($page - 1) * $perPage;
   // 给原SQL追加分页限制（注意如果原SQL已有LIMIT，要先正则替换掉）
   $paginatedSql = $sql . " LIMIT $perPage OFFSET $offset";
   $items = DB::select($paginatedSql);
   

3. 创建分页器实例
   把查询结果转成Collection，再实例化分页器：

   use Illuminate\Pagination\LengthAwarePaginator;
   use Illuminate\Pagination\Paginator;
   use Illuminate\Support\Collection;
   
   $collection = collect($items);
   $paginator = new LengthAwarePaginator(
       $collection,
       $total,
       $perPage,
       $page,
       [
           'path' => Paginator::resolveCurrentPath(), // 自动获取当前URL
           'pageName' => 'page', // 分页参数名，默认page
       ]
   );
   

4. 在视图中使用分页链接
   和Laravel自带的分页完全一样，直接调用links()方法：

   {{ $paginator->links() }}
   

方案二：使用DB::raw配合查询构建器（如果SQL可拆分） #

如果你的原生SQL可以拆分成查询构建器支持的部分（比如表名、条件、排序），也可以把SQL拆解后用查询构建器的分页方法，但这种方式只适合结构不复杂的SQL，比如：

// 假设原SQL是"SELECT * FROM orders WHERE status = 'completed' ORDER BY created_at DESC"
// 可以拆分成查询构建器：
$query = DB::table('orders')
           ->where('status', 'completed')
           ->orderBy('created_at', 'DESC');
$paginator = $query->paginate(15);

但如果你的SQL是非常复杂的多表关联、嵌套子查询，还是方案一更实用。

注意事项 #

• 处理SQL中的参数绑定：如果你的原生SQL包含占位符（比如?或命名占位符），执行时要传入绑定数组，分页时也要同步带上：

  $bindings = [1, 'active'];
  $items = DB::select($paginatedSql, $bindings);
  // 计算总条数时也要传入绑定
  $total = DB::selectOne($countSql, $bindings)->total;
  

• 移除原SQL中的LIMIT：如果存储的SQL本身已经带有LIMIT和OFFSET，一定要先正则替换掉，否则分页会出错：

  $sql = preg_replace('/LIMIT\s+\d+(?:\s+OFFSET\s+\d+)?$/i', '', $sql);
  

内容的提问来源于stack exchange，提问作者Ozal Zarbaliyev