简介
在其他框架中,分页可能是件非常痛苦的事,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
,推荐你手动查询数据库然后创建分页器。
1.自定义分页实现
手动创建分页器
有时候你可能想要通过传递数组数据来手动创建分页实例,你可以基于自己的需求通过创建 Illuminate\Pagination\Paginator
或 Illuminate\Pagination\LengthAwarePaginator
实例来实现。
Paginator
类不需要知道结果集中数据项的总数;不过,正因如此,该类也没有提供获取最后一页索引的方法。LengthAwarePaginator
接收参数和 Paginator
几乎一样,唯一不同在于它要求传入结果集的总数。
换句话说,Paginator
对应 simplePaginate
方法,而 LengthAwarePaginator
对应 paginate
方法。
注:当手动创建分页器实例的时候,应该手动对传递到分页器的结果集进行“切片”,如果你不确定怎么做,查看 PHP 函数 array_slice。
Model类的 UserModel.php
public function getList() {//获取用户列表 $perPage =3;//每页显示几条 $currentPage = 3;//当前第几页 $currentNum = $perPage*$currentPage;//从哪里开始产找数据 $results = DB::select('select * from user where 1 limit ?,?',[$currentNum,$perPage]); $total = DB::select('select COUNT(id) as id from user where 1 ');//数据总数 $total = $total[0]; $total = $total->id; //自定义分页类 $result = new \Illuminate\Pagination\LengthAwarePaginator($results,$total,$perPage,$currentPage,['ff=ff&ee=ee','dd=dd']); $result->setPath("?pa=sf&sdf=sdf&sdkf=sdf");//如果有搜索传递参数 return $result; }
控制器的 UserController.php
public function userList() { $userModel = new UserModel(); $res = $userModel->getList(); var_dump(htmlspecialchars($res->render()));//打印分页 var_dump($res->render());//打印分页 dd($res);//打印结果并终止 return $res; }
$res->links()也可以打印分页信息
结果:
下来我看自定义的分页样式怎么弄(好像很简单,只要把样式模板导出来修改就可以了,怎么导出来了,看下面介绍):
自定义分页视图
默认情况下,用于渲染分页链接的视图兼容 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->perPage() $results->previousPageUrl() $results->total() (使用simplePaginate 时无效) $results->url($page)
转:http://laravelacademy.org/post/8841.html