如何为DB::select()查询结果实现分页并调用links()方法？

这个需求太常见了——用原生SQL查出来的数组，想直接用Laravel分页的links()方法，完全不用改视图代码。最靠谱且高效的方式就是用Laravel内置的LengthAwarePaginator类，它能把普通数组包装成和Eloquent分页集合几乎一模一样的实例，完美支持分页导航功能。

具体步骤如下： #

1. 调整getReport方法，返回分页数据+总条数

首先需要让你的查询同时拿到当前页的数据和总记录数，这样分页组件才能计算总页数、上一页/下一页等逻辑。你可以把原有的复杂SQL拆成两个查询：一个查总条数（基于原SQL的子查询），另一个查分页后的结果。

public function getReport($advertisers, $category, int $offset, int $perPage): array {
    // 你的原生复杂SQL（注意保留ORDER BY，确保分页数据顺序稳定）
    $baseSql = '<我的复杂SQL语句>';

    // 1. 查询总记录数（用子查询包装原SQL，避免COUNT(*)的精度问题）
    $countSql = "SELECT COUNT(*) AS total FROM ($baseSql) AS count_subquery";
    $countResult = DB::select($countSql);
    $totalRecords = $countResult[0]->total;

    // 2. 查询当前页的数据，加入分页限制（注意用参数绑定防止SQL注入）
    $paginatedSql = $baseSql . " LIMIT ?, ?";
    $pageData = DB::select($paginatedSql, [$offset, $perPage]);

    return [$pageData, $totalRecords];
}

2. 在控制器中包装成LengthAwarePaginator实例

接下来在控制器里，获取当前页码、每页条数，计算偏移量，然后把查询到的数组和总条数传入LengthAwarePaginator：

use Illuminate\Pagination\LengthAwarePaginator;
use Illuminate\Pagination\Paginator;

public function index(OpenRegDepDataReportInterface $openRegDepDataReport, Request $request): Renderable {
    // 获取分页参数（可根据需求调整默认值）
    $currentPage = $request->get('page', 1);
    $perPage = 15; // 也可以从配置/请求中动态获取
    $offset = ($currentPage - 1) * $perPage;

    // 调用修改后的getReport方法，拿到数据和总条数
    [$applicationsData, $total] = $openRegDepDataReport->getReport($advertisers, $category, $offset, $perPage);

    // 包装成分页实例
    $applications = new LengthAwarePaginator(
        $applicationsData,
        $total,
        $perPage,
        $currentPage,
        [
            'path' => Paginator::resolveCurrentPath(), // 自动获取当前路由路径
            'pageName' => 'page', // 分页参数名，默认是page
        ]
    );

    return view('applications.index', compact('applications'));
}

3. 视图中直接使用$applications->links()

现在你在视图里可以完全像使用Eloquent分页集合一样调用$applications->links()，Laravel会自动渲染出标准的分页导航栏，和你之前用Eloquent的体验完全一致。

关键注意事项： #

• SQL注入防护：一定要用参数绑定的方式传递offset和perPage，不要直接拼字符串到SQL里，避免安全风险。
• 稳定排序：原SQL必须包含ORDER BY子句，并且排序字段是唯一的（比如主键ID），否则分页时可能出现数据重复或遗漏的情况。
• 性能优化：如果你的复杂SQL本身执行很慢，查总条数的子查询可能也会有性能问题，这时候可以考虑用近似计数（比如从数据库的information_schema里查），但精度会有所牺牲，根据业务场景选择即可。

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