在其他的框架中,实现分页是令人感到苦恼的事,但是 Laravel 令它实现起来变得轻松。 Laravel 可以产生基于当前页面的智能“范围”链接,所产生的 HTML 兼容 Bootstrap CSS 框架.
有几种方法来分页对象。最简单的是在搜索构建器使用 paginate
方法或 Eloquent 模型。
$users = DB::table('users')->paginate(15);
注意: 目前 Laravel 使用
groupBy
来做分页操作无法有效率的执行,如果您需要使用groupBy
来分页数据集,建议您手动查找数据库,并使用Paginator::make
。
有时你也许希望手动创建发呢也实例,传递一个数组作为参数。你可以根据需求创建 Illuminate\Pagination\Paginator
或者 Illuminate\Pagination\LengthAwarePaginator
实例。
您也可以对 Eloquent 模型分页:
$allUsers = User::paginate(15);
$someUsers = User::where('votes', '>', 100)->paginate(15);
发送给 paginate
方法的参数是您希望每页要显示的对象选项数目,只要您取得查找结果后,您可以在视图中显示,并使用 render
方法去建立分页链接:
<div class="container">
<?php foreach ($users as $user): ?>
<?php echo $user->name; ?>
<?php endforeach; ?>
</div>
<?php echo $users->render(); ?>
这就是所有建立分页系统的步骤了!您会注意到我们还没有告知 Laravel 我们目前的页面是哪一页,这个信息 Laravel 会自动帮您做好。
您也可以通过以下方法获得额外的分页信息:
currentPage
lastPage
perPage
hasMorePages
url
nextPageUrl
firstItem
lastItem
total
count
如果您只是要在您的分页视图显示“上一页”和“下一页”链接,您有个选项 simplePaginate
方法来执行更高效率的搜索。当您不需要精准的显示页码在视图上时,这个方法在较大的数据集非常有用:
$someUsers = User::where('votes', '>', 100)->simplePaginate(15);
有的时候您可能会想要从数组中对象手动建立分页实体, 您可以根据您的需要通过 Illuminate\Pagination\Paginator
或 Illuminate\Pagination\LengthAwarePaginator
实体来建立。
您还可以透过 setPath
方法自定义使用的 URL:
$users = User::paginate();
$users->setPath('custom/url');
上面的例子将建立 URL,类似以下内容: http://example.com/custom/url?page=2
您可以使用 appends
方法增加搜索字串到分页链接中:
<?php echo $users->appends(['sort' => 'votes'])->render(); ?>
这样会产生类似下列的链接:
http://example.com/something?page=2&sort=votes
如果您想要将“哈希片段”加到分页的 URL,您可以使用 fragment
方法:
<?php echo $users->fragment('foo')->render(); ?>
此方法调用后将产生 URL,看起来像这样:
http://example.com/something?page=2#foo
Paginator
类实现 Illuminate\Contracts\Support\JsonableInterface
接口的 toJson
方法。由路由返回的值,您可能将 Paginator
实体传换成 JSON。JSON 表单的实体会包含一些“元”信息,例如 total
、current_page
、last_page
。该实体数据将可通过在
JSON 数组中 data
的键取得。