内容简介:在其他框架中,分页可能是件非常痛苦的事,Laravel 让这件事变得简单、易于上手。Laravel 的分页器与查询构建器和Eloquent ORM 集成在一起,并开箱提供方便的、易于使用的、基于数据库结果集的分页。分页器生成的 HTML 兼容有多种方式实现分页功能,最简单的方式就是使用查询构建器或 Eloquent 查询提供的让我们先来看看如何在查询中调用
简介
在其他框架中,分页可能是件非常痛苦的事,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() }}
调整分页链接窗口
你可以控制在每个分页 URL「窗口」(分页器)中除当前页面链接之外显示几个额外链接,默认情况下是三个,你可以使用 onEachSide
方法来修改这个默认值:
{{ $users->onEachSide(5)->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。
如果你想要指定其他文件作为默认分页视图,可以在 AppServiceProvider
中使用分页器的 defaultView
和 defaultSimpleView
方法:
use Illuminate\Pagination\Paginator; public function boot() { Paginator::defaultView('pagination::view'); Paginator::defaultSimpleView('pagination::view'); }
分页器实例方法
每个分页器实例都可以通过以下方法提供更多分页信息:
$results->count() $results->currentPage() $results->firstItem() $results->hasMorePages() $results->lastItem() $results->lastPage() (使用simplePaginate 时无效) $results->nextPageUrl() $results->onFirstPage() $results->perPage() $results->previousPageUrl() $results->total() (使用simplePaginate 时无效) $results->url($page)
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:- Python操作docx文档
- Elasticsearch入门教程:索引和文档操作
- [ Laravel 5.7 文档 ] 数据库操作 —— 迁移
- [ Laravel 5.7 文档 ] 数据库操作 —— Redis
- [ Laravel 5.7 文档 ] 数据库操作 —— 数据填充
- [ Laravel 5.7 文档 ] 数据库操作 —— 快速入门
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
R语言实战(第2版)
[美] Robert I. Kabacoff / 王小宁、刘撷芯、黄俊文等 / 人民邮电出版社 / 2016-5 / 99.00元
本书注重实用性,是一本全面而细致的R指南,高度概括了该软件和它的强大功能,展示了使用的统计示例,且对于难以用传统方法处理的凌乱、不完整和非正态的数据给出了优雅的处理方法。作者不仅仅探讨统计分析,还阐述了大量探索和展示数据的图形功能。新版做了大量更新和修正,新增了近200页内容,介绍数据挖掘、预测性分析和高级编程。一起来看看 《R语言实战(第2版)》 这本书的介绍吧!