laravel 基础教程 —— 分页

分页

简介

在其余框架中,分页平时是相比较痛苦的。laravel 使其变的万分简单。laravel
可以依据当下页面很快的变型智能的限量链接,并且其变化的 HTML 是兼容
Bootstrap CSS
framework
的。

基础用法

对查询构建器结果开展分页

此间有三种艺术来对元素进行分页。而最简单易行的格局就是因此使用查询构造器或者
Eloquent 查询的 paginate 方法。paginate
方法会按照最近用户所走访的脚下页面来机关的装置科学的移动和出示的限制。默认的,当前页面是透过
HTTP 请求的查询字符串 ?page 来自动获取的。当然,laravel
会自动的检测到那个值,并且会自行的在变化无常的分页器的链接中插入合适的值。

第一,让我们来看一下在询问中调用 paginate
方法。在这多少个例子中,你仅需要在 paginate
方法中传递每页所需要显示的数目。让我们来设置每页突显的数额为 15 :

<?php

namespace App\Http\Controllers;

use DB;
use App\Http\Controllers\Controller;

class UserController extends Controller
{
  /**
   * Show all of the users for the application.
   *
   * @return Response
   */
   public function index()
   {
     $users = DB::table('users')->paginate(15);

     return view('user.index', ['users' => $users]);
   }
}

注意:目前,laravel 中使用 groupBy
语法不可以科学的展开分页操作。假使你需要使用 groupBy
来对结果举办分页,推荐您手动的推行查询和开展分页。

总而言之的分页

如果你只需要简单的展现“上一页”和“下一页”链接,你可以选择采纳
simplePaginate
方法来进行一个使得的询问。这对于部分大型的数据库在视图中不需要出示每一页的链接时特别实惠:

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

对 Eloquent 结果开展分页

你也足以对 Eloquent 查询的结果开展分页。我们来对 User 模型以每页显示15 项的方法来拓展分页。其语法和行使查询构造器举办分页分外像:

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

理所当然,你也足以优先开展任何查询未来再进行分页操作:

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

您一样也足以在 Eloquent 模型分页时使用 simplePaginate 方法:

$user = User::where('votes', '>', 100)->simplePaginate(15);

手动的创制分页器

突发性你或许需要手动的创设一个分页实例,它传递项目标数组。你可以创制
Illuminate\Pagination\Paginator 或者
Illuminate\Pagination\LengthAwarePaginator 实例,这取决你的需求。

Paginator
类不需要了解结果中项目标总数量。事实上,正是因为这么,这一个类并不曾提供获取最终一页的措施。LengthAwarePaginator
类似于 Paginator
接收几乎千篇一律的参数。可是,它需要在结果中带有项目标总和目。

一派,Paginator 对应查询构造器和 Eloquent 中的 simplePaginate
方法。而 LengthAwarePaginator 对应 paginate 方法。

当手动的创办分页器实例时,你应有手动的对传递到分页器中的结果开展切开操作,假设你并不明白怎样去开展分片,请查看
PHP 的
array_slice
方法。

在视图中展现结果

当你对查询构造器或者 Eloquent 查询利用 paginate 或者 simplePaginate
方法时,你可以拿走到分页器的实例。当调用 paginate
方法时,你会得到到一个 Illuminate\Pagination\LengthAwarePaginator
实例,当调用 simplePaginate 方法时,你会博得一个
Illuminate\Pagination\Paginator
的实例。这么些目的会提供多种措施来叙述结果集。除了这一个帮扶方法,分页器本身也是一个迭代器,它可以像数组一样被循环操作。

故此,一旦你获取到了分页结果,你可以像这么在 Blade
视图中来呈现和转移分页链接:

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

{{ $users->links() }}

links 方法会依据结果集来生成分页结果。对每一个链接都会活动包含 ?page
查询变量。使用 links 方法生成的 HTML 是配合 Bootstrap CSS 框架的。

自定义分页器 URL

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() }}

倘使您需要在分页器的 URLs 中添加一个 hash 分段,你可以运用 fragment
方法。比如,在分页链接中添加 #foo

{{ $users->fragment('foo')->links() }}

任何襄助方法

您能够调用分页器实例的底下的法子来访问额外的分页器信息:

  • $results->count()
  • $results->currentPage()
  • $results->firstItem()
  • $results->hasMorePages()
  • $results->lastItem() (Not avaliable when using simplePaginate)
  • $results->nextPageUrl()
  • $results->perPage()
  • $results->previousPageUrl()
  • $results->total() (Not available when using simplePaginate)
  • $results->url($page)

转移结果为 JSON

laravel 的分页器类实现了
Illuminate\Contracts\Support\JsonableInterface 契约并且透露了 toJson
方法,所以它可以卓殊简单的将分页结果转换为 JSON 格式。

你也足以在路由或者控制器动作中概括的回到分页器实例来开展 JSON
格式的响应:

Route::get('users', function () {
  return App\User::paginate(); 
});

分页器的 JSON 消息会蕴藏众多的元数据,比如
totalcurrent_pagelast_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
        }
   ]
}

相关文章