对于一个需要进行分页处理的列表页面，如何在 Laravel 控制器中实现分页逻辑，并将分页数据传递给视图？

本文链接：https://blog.csdn.net/qq_36777143/article/details/146107825

在 Laravel 中，分页是一种非常常见的需求，尤其是在处理大量数据时。Laravel 提供了强大的内置分页功能，可以轻松实现分页逻辑，并将分页数据传递给视图。

一、实现步骤

1. 使用 Eloquent 实现分页

Laravel 的 Eloquent ORM 提供了 paginate() 方法，用于自动分页查询结果。

示例代码

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\User;

class UserController extends Controller
{
    /**
     * 显示用户列表并分页。
     *
     * @return \Illuminate\View\View 视图响应
     */
    public function index()
    {
        // 每页显示 10 条数据
        $users = User::paginate(10);
        // 为什么这样写？
        // 使用 paginate() 方法自动分页查询结果，并返回一个分页对象。

        return view('users.index', compact('users'));
        // 为什么这样写？
        // 将分页数据传递给视图，便于渲染分页链接和数据。
    }
}

为什么这样写？
- paginate() 方法会根据当前页码自动限制查询结果，并生成分页元数据（如总页数、当前页等）。
- 分页对象包含查询结果和分页信息，可以直接传递给视图。

2. 在视图中渲染分页数据

Laravel 提供了内置的分页视图组件，可以轻松渲染分页链接。

示例代码（`resources/views/users/index.blade.php`）

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>User List</title>
</head>
<body>
    <h1>User List</h1>

    <!-- 显示用户数据 -->
    <ul>
        @foreach ($users as $user)
            <li>{{ $user->name }}</li>
        @endforeach
    </ul>

    <!-- 渲染分页链接 -->
    {{ $users->links() }}
    <!-- 为什么这样写？ -->
    <!-- links() 方法会自动生成分页链接，支持上一页、下一页和页码导航。 -->
</body>
</html>

为什么这样写？
- $users->links() 方法会生成 HTML 分页链接，样式默认基于 Bootstrap。
- 如果需要自定义样式，可以发布分页视图并修改模板。

3. 自定义分页样式（可选）

如果需要自定义分页样式，可以通过以下命令发布分页视图文件：

php artisan vendor:publish --tag=laravel-pagination

这会在 resources/views/vendor/pagination/ 目录下生成默认的分页视图文件（如 default.blade.php）。您可以根据需要修改这些文件。

4. 测试分页功能

启动开发服务器并访问 /users 页面，确保分页功能正常工作：

第一页：显示前 10 条数据。
第二页：点击分页链接，显示第 11 到 20 条数据。
自动分页：当数据量超过每页限制时，分页链接会自动显示。

二、底层原理

1. 分页的工作机制

作用：
- 将大量数据分成多个页面，避免一次性加载过多数据。
原理：
- paginate() 方法会根据当前页码和每页条数计算查询的偏移量（OFFSET）和限制（LIMIT）。
- 查询结果会被封装到一个分页对象中，包含数据和分页元信息（如总页数、当前页等）。

2. 分页对象的内容

数据部分：
- 包含当前页的数据集合。
元信息部分：
- 包括总记录数、总页数、当前页码、每页条数等。

3. 分页链接的生成

作用：
- 自动生成分页链接，支持上一页、下一页和页码导航。
原理：
- Laravel 根据当前请求的 URL 和分页参数（如 ?page=2）生成分页链接。
- 默认支持 Bootstrap 样式，也可以自定义样式。

三、总结

1. 为什么需要分页？

性能优化：避免一次性加载大量数据，提升页面加载速度。
用户体验：通过分页导航，用户可以更方便地浏览数据。
可维护性：分页逻辑由框架自动处理，减少手动编码的工作量。

2. 底层原理总结

分页查询：通过 paginate() 方法自动计算偏移量和限制。
分页对象：包含查询结果和分页元信息。
分页链接：根据当前请求生成分页导航链接。

3. 注意事项

性能优化：确保数据库查询使用索引，避免分页查询性能下降。
调试工具：结合日志或调试工具排查分页问题。
安全性：防止恶意请求（如超大页码）导致性能问题。