2、基本使用 2.1 基于查询构建器分页
有多种方式实现分页,最简单的方式就是使用查询构建器或 eloquent模型的 paginate方法。该方法基于当前用户查看页自动设置合适的偏移(offset)和限制(limit)。默认情况下,当前页通过http请求查询字符串参数 ?page的值判断。当然,该值由laravel自动检测,然后自动插入分页器生成的链接中。
让我们先来看看如何在查询上调用 paginate方法。在本例中,传递给 paginate的唯一参数就是你每页想要显示的数目,这里我们指定每页显示 15个:
paginate(15); return view('user.index', ['users' => $users]); }}
注意:目前,使用 groupby的分页操作不能被laravel有效执行,如果你需要在分页结果中使用 groupby,推荐你手动查询数据库然后创建分页器。
简单分页
如果你只需要在分页视图中简单的显示“下一个”和“上一个”链接,可以使用 simplepaginate方法来执行该查询。在渲染包含大数据集的视图且不需要显示每个页码时非常有用:
$users = db::table('users')->simplepaginate(15);
2.2 基于eloquent 模型分页
你还可以对eloquent查询结果进行分页,在本例中,我们对 user模型进行分页,每页显示 15条记录。正如你所看到的,该语法和基于查询构建器的分页差不多:
$users = app\user::paginate(15);
当然,你可以在设置其它约束调价之后调用 paginate,比如 where子句:
$users = user::where('votes', '>', 100)->paginate(15);
你也可以使用 simplepaginate方法:
$users = user::where('votes', '>', 100)->simplepaginate(15);
2.3 手动创建分页器
有时候你可能想要通过传递数组数据来手动创建分页实例,你可以基于自己的需求通过创建 illuminate\pagination\paginator或 illuminate\pagination\lengthawarepaginator实例来实现。
paginator类不需要知道结果集中数据项的总数;然而,正因如此,该类也没有提供获取最后一页索引的方法。
lengthawarepaginator接收参数和 paginator几乎一样,只是,它要求传入结果集的总数。
换句话说, paginator对应 simplepaginate方法,而 lengthawarepaginator对应 paginate方法。
当手动创建分页器实例的时候,应该手动对传递到分页器的结果集进行“切片”,如果你不确定怎么做,查看php函数 array_slice。
3、在视图中显示分页结果 当你调用查询构建器或eloquent查询上的 paginate或 simplepaginate方法时,你将会获取一个分页器实例。当调用 paginate方法时,你将获取 illuminate\pagination\lengthawarepaginator,而调用方法 simplepaginate时,将会获取 illuminate\pagination\paginator实例。这些对象提供相关方法描述这些结果集,除了这些帮助函数外,分页器实例本身就是迭代器,可以像数组一样对其进行循环调用。
所以,获取到结果后,可以按如下方式使用blade显示这些结果并渲染页面链接:
@foreach ($users as $user) {{ $user->name }} @endforeach
{!! $users->links() !!}
links方法将会将结果集中的其它页面链接渲染出来。每个链接已经包含了 ?page查询字符串变量。记住, render方法生成的html兼容 bootstrap css 框架。
注意:我们从blade模板调用 render方法时,确保使用 {!! !!}语法以便html链接不被过滤。
自定义分页链接
setpath方法允许你生成分页链接时自定义分页器使用的uri,例如,如果你想要分页器生成形如 http://example.com/custom/url?page=n的链接,应该传递 custom/url到 setpath方法:
route::get('users', function () { $users = app\user::paginate(15); $users->setpath('custom/url'); //});
添加参数到分页链接
你可以使用 appends方法添加查询参数到分页链接查询字符串。例如,要添加 &sort=votes到每个分页链接,应该像如下方式调用 appends:
{!! $users->appends(['sort' => 'votes'])->links() !!}
如果你想要添加”哈希片段”到分页链接,可以使用 fragment方法。例如,要添加 #foo到每个分页链接的末尾,像这样调用 fragment方法:
{!! $users->fragment('foo')->links() !!}
更多辅助方法
你还可以通过如下分页器实例上的方法访问更多分页信息:
$results->count() $results->currentpage() $results->firstitem() $results->hasmorepages() $results->lastitem() $results->lastpage() (使用simplepaginate时无效) $results->nextpageurl() $results->perpage() $results->previouspageurl() $results->total() (使用simplepaginate时无效) $results->url($page) 4、将结果转化为json laravel分页器结果类实现了 illuminate\contracts\support\jsonableinterface契约并实现 tojson方法,所以将分页结果转化为json非常简单。
你还可以简单通过从路由或控制器动作返回分页器实例将转其化为json:
route::get('users', function () { return app\user::paginate();});
从分页器转化来的json包含了元信息如 total, current_page, last_page等等,实际的结果对象数据可以通过该json数组中的 data键访问。下面是一个通过从路由返回的分页器实例创建的json例子:
{ total: 50, per_page: 15, current_page: 1, last_page: 4, next_page_url: http://laravel.app?page=2, prev_page_url: null, from: 1, to: 15, data:[ { // result object }, { // result object } ]}
