[ 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)
[ Laravel 5.5 文档 ] 数据库操作 —— 在 Laravel 中轻松实现分页功能的更多相关文章
- MongoDB数据库、集合、文档的操作
MongoDB系列第一课:MongDB简介 MongoDB系列第二课:MongDB环境搭建 MongoDB系列第三课:MongDB用户管理 MongoDB系列第四课:MongoDB数据库.集合.文档的 ...
- MongoDB .Net Driver(C#驱动) - 内嵌数组/嵌入文档的操作(增加、删除、修改、查询(Linq 分页))
目录 一.前言 1. 运行环境 二.前期准备工作 1. 创建 MongoDBContext MongoDb操作上下文类 2.创建测试类 3.创建测试代码 三.内嵌数组增加元素操作 1.Update.S ...
- MongoDB入门---文档查询操作之条件查询&and查询&or查询
经过前几天的学习之路,今天终于到了重头戏了.那就是文档查询操作.话不多说哈,直接看下语法: db.collection.find(query, projection) query :可选,使用查询操作 ...
- [ Laravel 5.5 文档 ] 处理用户请求 —— HTTP 请求的过滤器:中间件
[ Laravel 5.5 文档 ] 处理用户请求 —— HTTP 请求的过滤器:中间件 http://laravelacademy.org/post/7812.html 简介 中间件为过滤进入应用的 ...
- C# 使用XmlDocument类对XML文档进行操作
原创地址:http://www.cnblogs.com/jfzhu/archive/2012/11/19/2778098.html 转载请注明出处 W3C制定了XML DOM标准.很多编程语言中多提供 ...
- JS对文档进行操作
对文档进行操作 创建节点 追加节点 删除节点 任务及例子 总结 对DOM的修改是,构建动态网页的关键.使用下面列举的方法,我们可以创建新的网页并且动态进行更改. 更多的DOM操作方法请查 DOM1 ...
- MongoDB模拟多文档事务操作
Mongodb不支持多文档原子性操作,因此依据两阶段提交协议(Two Phase Commits protocol)来模拟事务. 以两个银行账户之间的转账行为为例,来说明如何实现多文档间的事务操作. ...
- c# word文档的操作
参考https://blog.csdn.net/ruby97/article/details/7406806 Word对象模型 (.Net Perspective) 本文主要针对在Visual St ...
- jQuery-对标签元素 文本操作-属性操作-文档的操作
一.对标签元素文本操作 1.1 对标签中内容的操作 // js var div1 = document.getElementById("div1"); div1.innerText ...
随机推荐
- win10系统修改Intel VT-x时进入不了BIOS问题
一般电脑进入BIOS的方式都是在开机的时候不停的按F2或者F12,但是Win10系统由于支持快速启动,当win10系统快速启动的时候,按F12或者F2是没反应的,解决方式: 第一步:修改win10的启 ...
- JAVA 文件转字节数组转字符串
public static void main(String[] args) throws IOException { byte[] bytes = FileUtils.readFileToByteA ...
- Linux Shell基础 位置参数变量、预定义变量
位置参数变量 在 Linux 的命令行中,当一条命令或脚本执行时,后面可以跟多个参数,我们使用位置参数变量来表示这些参数.其中,$0 代表命令行本身,$1 代表第 1 个参数,$2 代表第 2 个参数 ...
- Python自然语言处理-系列一
一:python基础,自然语言概念 from nltk.book import * 1,text1.concordance("monstrous") 用语索引 2,tex ...
- 大数据架构之:Flume
1. Flume是一个分布式.可靠.和高可用的海量日志聚合的系统,支持在系统中定制各类数据发送方,用于收集数据:同时,Flume提供对数据进行简单处理,并写到各种数据接受方(可定制)的能力. 2.一个 ...
- Qt移植对USB鼠标键盘、触摸屏的支持
.USB键盘 经过一番搜索,发现对Qt键盘的支持主要关系到两个方面: 1. 键盘类型确定: 4.7以前的Qt版本,如果是PS2圆孔键盘,Qt编译时需加上选项:-qt-kbd-vr41xx(未测试):如 ...
- C++学习 之pair
Pair类型概述 pair是一种模板类型,其中包含两个数据值,两个数据的类型可以不同,基本的定义如下: pair<int, string> a; 表示a中有两个类型,第一个元素是int型的 ...
- seajs 入门
最近想搞搞JS模块化, 读到了园子里的一篇好文: http://www.cnblogs.com/lvdabao/p/js-modules-develop.html 看里面讲seajs不错, 于是想学 ...
- Python面向对象的编程注意细节
和前文一样,这了也是学习过程中,来源于网上各种资料的一个整合记录,希望能够帮到自己和大家: 主要的关注点是在使用class的时候,应该注意的一些细节: 1.在class里面,有了 __init__(s ...
- How does asp.net web api work?
https://hub.packtpub.com/working-aspnet-web-api/ https://docs.microsoft.com/en-us/aspnet/web-api/ove ...