You need to enable JavaScript to run this app. Laravel DataTables 如何实现后端分页每次查询10条记录
优惠活动
大模型
产品
解决方案
定价
更多

Laravel DataTables 如何实现后端分页每次查询10条记录

核心问题根因

全量拉取数据的原因很直接:在把查询结果传给DataTables之前,代码就已经用User::all()->get()把整张表的数据从数据库查出来了,哪怕前端开了serverSide: true,后端拿到的已经是全量集合,根本没法走数据库层面的按需分页。
Laravel DataTables实现服务端分页的逻辑很直白:把模型的查询构造器实例传给插件,不要提前执行查询,让插件自动根据前端传过来的分页、排序、搜索参数拼接SQL,真正做到每次只查当前页需要的条目数。

具体调整方案

1. 修正后端控制器查询逻辑

把UserController里的getData方法改成下面的写法,核心是去掉提前执行的all()/get():

// Get Users Using Datatables
public function getData()
{
    // 关键:直接传查询构造器,不要提前执行all()/get()拉全表
    $users = User::query();

    return Datatables::of($users)
        ->editColumn('user_id', function ($user) {
            // 修正原代码的单引号字符串解析问题:单引号里的PHP变量不会被解析
            return '<span class="text-red">' . $user->user_id . '</span>';
        })
        ->addColumn('btn_login', function ($user) {
            return $user->is_active . '<a class="btn btn-default" type="button" href="#">Sample</a>';
        })
        // 把返回HTML的列都加入rawColumns,避免前端把标签当文本转义
        ->rawColumns(['btn_login', 'user_id'])
        ->make(true);
}

效果:插件拿到查询构造器后,会自动读取前端传过来的分页参数(起始偏移量、每页条数、排序字段、搜索关键词),自动拼接对应的SQL条件,第一次请求时只查offset=0, limit=10的10条数据,点击下一页时再根据新的offset查offset=10, limit=10的下一批数据,完全不会提前把全表数据拉到PHP内存里。

2. 调整前端表格配置

你已经正确开启了serverSide: true,只需要显式指定每页条数为10即可,避免默认值变动带来的问题:

$('#users-table').DataTable({
    processing: true,
    responsive: true,
    serverSide: true,
    stateSave: true,
    order: [ [0, "desc"] ],
    pageLength: 10, // 明确设置每页展示10条
    lengthMenu: [10, 25, 50, 100], // 可选:给用户提供切换每页条数的选项
    ajax: '{{ route("api.user.list") }}',
    columns: [
        {data: 'user_id'},
        {data: 'name'},
        {data: 'email'},
        {
            data: 'phone_number',
            defaultContent: "---"
        },
        {data: 'btn_login'}
    ]
});

3. 附带修正两个现有代码的隐藏bug

  • 路由指向错误:你当前web.php里写的Route::get('/api/userlist', 'UsersController@getData'),控制器名是复数UsersController,但你实际的控制器文件是单数UserController.php,在Linux等区分大小写的服务器环境下,会直接报类不存在的错误,需要把路由里的控制器名改成和实际文件一致的UserController@getData。
  • 原有HTML列的字符串解析错误:之前写的'<span class="text-red">$user->user_id</span>'用的是单引号,PHP不会解析里面的变量,前端会直接显示字面量的$user->user_id文本,不会显示真实的用户ID值,已经在上面的代码里修正了拼接逻辑。

内容的提问来源于stack exchange,提问作者laurence keith albano

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 01:06:11