[ Laravel 5.5 文档 ] 数据库操做 —— 在 Laravel 中轻松实现分页功能



简介

在其余框架中，分页是件很是痛苦的事，Laravel 让这件事变得简单易于上手。Laravel 的分页器与查询构建器和 Eloquent ORM 集成在一块儿，并开箱提供方便的、易于使用的、基于数据库结果集的分页。分页器生成的 HTML 兼容Bootstrap CSS 框架。

基本使用

基于查询构建器进行分页

有多种方式实现分页功能，最简单的方式就是使用查询构建器或 Eloquent 查询提供的 paginate 方法。该方法基于当前用户查看页自动设置合适的偏移（offset）和限制（limit），直白点说就是页码和每页显示数量。默认状况下，当前页经过 HTTP 请求查询字符串参数 page 的值判断。固然，该值由 Laravel 自动检测，而后自动插入分页器生成的连接中。

让咱们先来看看如何在查询中调用 paginate 方法。在本例中，传递给 paginate 的惟一参数就是你每页想要显示的数目，这里咱们指定每页显示 15 个：

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\DB;
use App\Http\Controllers\Controller;

class UserController extends Controller
{
    /**
     * 显示应用中的全部用户
     *
     * @return Response
     */
    public function index()
    {
        $users = DB::table('users')->paginate(15);
        return view('user.index', ['users' => $users]);
    }
}

　　

注：目前，使用 groupBy 的分页操做不能被 Laravel 有效执行，若是你须要在分页结果中使用 groupBy，推荐你手动查询数据库而后建立分页器。

简单分页

若是你只须要在分页视图中简单的显示“下一页”和“上一页”连接，可使用 simplePaginate 方法来执行一个更加高效的查询。在渲染包含大数据集的视图且不须要显示每一个页码时这一功能很是有用：

$users = DB::table('users')->simplePaginate(15);

基于Eloquent结果集进行分页

你还能够对 Eloquent 查询结果进行分页，在本例中，咱们对 User 模型进行分页，每页显示 15 条记录。正如你所看到的，该语法和基于查询构建器的分页差很少：

$users = App\User::paginate(15);

固然，你能够在设置其它约束条件以后调用 paginate，好比 where 子句：

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

在对 Eloquent 模型进行分页时你也可使用 simplePaginate 方法：

$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 实例。这些对象提供相关方法描述这些结果集，除了这些辅助函数外，分页器实例自己就是迭代器，能够像数组同样对其进行循环调用。因此，获取到结果后，能够按以下方式使用 Blade 显示这些结果并渲染页面连接：

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

{{ $users->links() }}

links 方法将会将结果集中的其它页面连接渲染出来。每一个连接已经包含了 page 查询字符串变量。记住，render方法生成的 HTML 兼容 Bootstrap CSS 框架。

自定义分页连接

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');
    //
});

添加参数到分页连接

你可使用 appends 方法添加查询参数到分页连接查询字符串。例如，要添加 &sort=votes 到每一个分页连接，应该像以下方式调用 appends：

{{ $users->appends(['sort' => 'votes'])->links() }}

若是你想要添加”哈希片断”到分页连接，可使用 fragment 方法。例如，要添加 #foo 到每一个分页连接的末尾，像这样调用 fragment 方法：

{{ $users->fragment('foo')->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,
   "first_page_url": "http://laravel.app?page=1",
   "last_page_url": "http://laravel.app?page=4",
   "next_page_url": "http://laravel.app?page=2",
   "prev_page_url": null,
   "path": "http://laravel.app",
   "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)