laravel5.4 | 分页

最简单的方式就是使用 查询构建器 或 Eloquent 查询的 paginate 方法。该

DB
显示15个
$users = DB::table('users')->paginate(15);
return view('user.index', ['users' => $users]);

简单分页,只显示上一页/下一页
$users = DB::table('users')->simplePaginate(15);

Eloquent
$users = App\User::paginate(15);
$users = User::where('votes', '>', 100)->simplePaginate(15);

手动创建分页器
有时候你可能想要通过传递数组数据来手动创建分页实例，你可以基于自己的需求通过创建 Illuminate\Pagination\Paginator 或 Illuminate\Pagination\LengthAwarePaginator 实例来实现。

Paginator 类不需要知道结果集中数据项的总数；不过，正因如此，该类也没有提供获取最后一页索引的方法。LengthAwarePaginator 接收参数和 Paginator 几乎一样，只是，它要求传入结果集的总数。

换句话说，Paginator 对应 simplePaginate 方法，而LengthAwarePaginator 对应 paginate 方法。

注：当手动创建分页器实例的时候，应该手动对传递到分页器的结果集进行“切片”，如果你不确定怎么做，查看 PHP 函数 array_slice。

显示分页结果
调用paginate 方法时，你将获取Illuminate\Pagination\LengthAwarePaginator 实例，而
调用方法simplePaginate 时，将会获取 Illuminate\Pagination\Paginator 实例。

<div class="container">
@foreach ($users as $user)
{{ $user->name }}
@endforeach
</div>
{{ $users->links() }}

自定义分页链接
withPath 方法允许你生成分页链接时自定义分页器使用的 URI，例如，如果你想要分页器生成形如http://example.com/custom/url?page=N 的链接，应该传递 custom/url 到 withPath 方法：

Route::get('users', function () {
$users = App\User::paginate(15);
$users->withPath('custom/url');
//
});

分页链接中添加参数
{{ $users->appends(['sort' => 'votes'])->links() }}

将结果转化为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
}
]
}

自定义分页视图
默认情况下，用于渲染分页链接的视图兼容于Bootstrap CSS 框架，如果你没有使用Bootstrap，可以自定义视图来渲染这些链接。当调用分页器实例上的 links 方法时，传递视图名称作为第一个参数：

{{ $paginator->links('view.name') }}

// 传递数据到视图...
{{ $paginator->links('view.name', ['foo' => 'bar']) }}
不过，自定义分页视图最简单的方式是使用vendor:publish 命令导出视图文件到resources/views/vendor 目录：

php artisan vendor:publish --tag=laravel-pagination
该命令会将视图放到 resources/views/vendor/pagination 目录，该目录下的default.blade.php 文件对应默认的视图文件，编辑该文件即可修改分页 HTML。

分页器实例方法
每个分页器实例都可以通过以下方法提供更多分页信息：
$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)