简介
在其他框架中,分页可能是件非常痛苦的事,Laravel 让这件事变得简单、易于上手。Laravel 的分页器与查询构建器和 Eloquent ORM 集成在一起,并开箱提供方便的、易于使用的、基于数据库结果集的分页。分页器生成的 HTML 兼容 Bootstrap CSS 框架。
基本使用
基于查询构建器进行分页
有多种方式实现分页功能,最简单的方式就是使用查询构建器或 Eloquent 查询提供的 paginate 方法。该方法基于当前用户查看页自动设置合适的偏移(offset)和限制(limit),直白点说就是页码和每页显示数量。默认情况下,当前页通过 HTTP 请求查询字符串参数 page 的值判断。当然,该值由 Laravel 自动检测,然后自动插入分页器生成的链接中。
让我们先来看看如何在查询中调用 paginate 方法。在本例中,传递给 paginate 的唯一参数就是你每页想要显示的数目,这里我们指定每页显示 15 个:
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);
显示分页结果
当调用 paginate 方法时,你将获取Illuminate\Pagination\LengthAwarePaginator 实例,而调用方法simplePaginate 时,将会获取 Illuminate\Pagination\Paginator 实例。这些对象提供相关方法描述这些结果集,除了这些辅助函数外,分页器实例本身就是迭代器,可以像数组一样对其进行循环调用。所以,获取到结果后,可以按如下方式使用 Blade 显示这些结果并渲染页面链接:
@foreach ($users as $user)
{{ $user->name }}
@endforeach
{{ $users->links() }}
links 方法将会将结果集中的其它页面链接渲染出来。每个链接已经包含了 page 查询字符串变量。记住,render 方法生成的 HTML 兼容 Bootstrap CSS 框架。
带条件的分页
public function index()
{
$type = $this->request->get('type',1);
$users = DB::table('users')->where(function ($query) use ($type) {
if($type) {
$query->where('type', $type);
}
})->paginate(15);
return view('user.index', ['users' => $users]);
}
@foreach ($users as $user)
{{ $user->name }}
@endforeach
{!! $list->appends(['type'=>$type])->links() !!}