Laravel5.8
  1. 安装配置及核心内容
  2. 框架基础
  3. 进阶知识
  4. 数据库相关
    1. Laravel - 数据库相关 - 简介与配置
    2. Laravel - 数据库相关 - 原生 SQL 操作
    3. Laravel - 数据库相关 - 查询构造器
    4. Laravel - 数据库相关 - 分页
    5. Laravel - 数据库相关 - 数据迁移
    6. Laravel - 数据库相关 - 数据填充
    7. Laravel - 数据库相关 - redis
    8. Laravel - Eloquent 模型 - 入门
    9. Laravel - Eloquent 模型 - 查询作用域(全局,本地,动态)
    10. Laravel - Eloquent 模型 - 事件与监听方法
    11. Laravel - Eloquent 模型 - 关联关系
    12. Laravel - Eloquent 模型 - 关联查询
    13. Laravel - Eloquent 模型 - 访问器和修改器

Laravel - 数据库相关 - 分页

程序员日记      2019-09-05

简介

在其他框架中,分页可能是件非常痛苦的事,Laravel 让这件事变得简单、易于上手。

Laravel 的分页器与查询构建器和 Eloquent ORM 集成在一起,并开箱提供方便的、易于使用的、基于数据库结果集的分页。

分页器生成的 HTML 兼容 Bootstrap CSS 框架。


基本使用

查询构造器分页

示例

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

说明

每页显示15条数据


简单分页

示例

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

说明

1.只需要在分页视图中简单的显示“下一页”和“上一页”链接

2.使用 groupBy 的分页操作不能被 Laravel 有效执行,如果你需要在分页结果中使用 groupBy,推荐你手动查询数据库然后创建分页器。


Eloquent 结果集(模型)

分页

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

带条件的分页

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

简单分页

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


手动创建分液器

使用 Illuminate\Pagination\PaginatorIlluminate\Pagination\LengthAwarePaginator 这两个类实例

说明

Paginator 对应 simplePaginate 方法

LengthAwarePaginator 对应 paginate 方法。


显示分页

显示分页结果

{{ $users->links() }}


自定义分页链接

Route::get('users', function () {
    $users = App\User::paginate(15);
    $users->withPath('custom/url');
    //
});

说明

分页器会生成形如 http://example.com/custom/url?page=N 的链接


添加参数到分页链接

{{ $users->appends(['sort' => 'votes'])->links() }}

说明

会在每个分页链接添加 &sort=votes


添加”哈希片段”到分页链接

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

说明

会在每个分了链接添加 #foo


执行显示链接个数

{{ $users->onEachSide(5)->links() }}

说明

除当前页面链接之外显示5个额外链接


将结果转化为JSON

return App\User::paginate()-toJson();

通过从路由返回的分页器实例创建的 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
        }
   ]
}


自定义分页视图

{{ $paginator->links('view.name') }}

说明

传递视图名称


传递参数到自定义视图

{{ $paginator->links('view.name', ['foo' => 'bar']) }}

说明

第二个参数传递数组格式的参数数据


自定义页面视图

使用 vendor:publish 命令自定义分页视图最简单的方式是

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->getOptions() 获取分页选项
$results->getUrlRange($start, $end) 创建分页 URL 的范围
$results->hasMorePages() 判断是否还有足够多的项目用于分页
$results->lastItem() 获取结果集分片中最后一项的编号
$results->lastPage() 获取最后一页的页码(使用 simplePaginate 时无效)
$results->nextPageUrl() 获取下一页的 URL
$results->onFirstPage() 判断是否在第一页
$results->perPage() 每页显示的项目数
$results->previousPageUrl() 获取上一页的 URL
$results->total() 判断存储器中匹配的所有项目总数(使用 simplePaginate 时无效)
$results->url($page) 获取给定页码的分页 URL