Laravel模型分页通过paginate()方法实现，可自动处理SQL的LIMIT和OFFSET并计算分页信息；支持动态设置每页数量、自定义分页样式及API接口中返回JSON格式数据，便于前后端交互。
Laravel模型分页这事儿，说白了就是把数据库里一大堆数据，按你想要的大小，切成一页一页的，然后一页一页地展示出来。核心就是用
paginate()方法，而获取这些分页数据，就是操作
paginate()返回的那个分页器对象。
Laravel模型分页的实现，主要依赖于Eloquent查询构建器或DB查询构建器上的
paginate()方法。这个方法用起来挺直观的，你只需要在你想要分页的查询后面链式调用它，并传入每页显示的数量即可。比如，如果你想把
Post模型的所有文章分页，每页显示15篇，代码大概就是这样：
use App\Models\Post; // 在控制器或服务中 $posts = Post::query()->paginate(15); // 这样，$posts就是一个Paginator实例了 // 视图中可以直接循环 $posts 来展示数据 // 并且可以通过 $posts->links() 来生成分页导航
paginate(15)会帮我们处理好SQL语句中的
LIMIT和
OFFSET，还会自动计算总页数、当前页等信息。有时候，如果你只是想简单地显示“上一页/下一页”按钮，而不需要知道总共有多少页，可以使用
simplePaginate(15)，这样可以减少数据库的查询开销，因为它不会去执行
COUNT(*)操作。这在数据量特别大，或者对性能要求极高的场景下，是个不错的优化点。
Laravel分页器如何自定义每页显示数量及样式？
说实话，自定义每页显示数量是挺常见的需求。我们不能总是写死一个数字，用户可能想看多点或少点。最灵活的方式，我觉得是结合请求参数来动态设置。比如，从URL里获取一个
per_page参数，如果用户没传，就给个默认值。
use Illuminate\Http\Request;
use App\Models\Post;
public function index(Request $request)
{
$perPage = $request->input('per_page', 10); // 默认每页10条
$posts = Post::query()->paginate($perPage);
return view('posts.index', compact('posts'));
}这样，用户访问
your-app.com/posts?per_page=20就能看到每页20条了。
至于分页器的样式，Laravel默认提供了一套基于Tailwind CSS或Bootstrap的样式，通过
$posts->links()方法就能渲染出来。但很多时候，我们自己的项目有独特的UI风格，或者压根没用这些前端框架。这时候，我们可以发布Laravel自带的分页视图文件进行修改：
php artisan vendor:publish --tag=laravel-pagination
执行完这条命令后，你会发现
resources/views/vendor/pagination目录下多了一些
.blade.php文件，比如
tailwind.blade.php、
bootstrap-4.blade.php等。你可以选择其中一个作为基础，复制一份，然后按照你的设计稿去修改HTML和CSS。修改完后，在你的服务提供者（比如
AppServiceProvider）的
boot方法里指定使用你的自定义视图：
use Illuminate\Pagination\Paginator;
public function boot()
{
Paginator::useBootstrapFive(); // 或者 Paginator::defaultView('your-custom-pagination-view');
}我个人觉得，直接改动这些Blade文件，自由度是最高的。不过，如果只是想微调颜色字体啥的，直接在项目CSS里覆盖默认样式也行，看你需求了。
获取Laravel分页数据时，如何提取总数、当前页等关键信息？
当你调用
paginate()方法后，返回的并不是一个普通的集合，而是一个
Illuminate\Pagination\LengthAwarePaginator（或
Paginator）实例。这个实例里面封装了所有你可能需要的关于分页的信息。这玩意儿，用起来真是方便。
假设我们有
$posts = Post::query()->paginate(15);，你可以这样获取各种信息：
-
当前页码：
$posts->currentPage()
-
总页数：
$posts->lastPage()
-
每页显示数量：
$posts->perPage()
-
总记录数：
$posts->total()
-
当前页的第一条记录索引：
$posts->firstItem()
(这是相对于总记录数的索引，从1开始) -
当前页的最后一条记录索引：
$posts->lastItem()
-
是否有更多页（即是否还有下一页）：
$posts->hasMorePages()
-
获取当前页的数据集合：
$posts->items()
或直接$posts->getCollection()
这些方法在视图里特别有用，比如你可能想显示“显示第X到Y条，共Z条记录”这样的信息。
显示第 {{ $posts->firstItem() }} 到 {{ $posts->lastItem() }} 条， 共 {{ $posts->total() }} 条记录。 当前在第 {{ $posts->currentPage() }} 页，总共 {{ $posts->lastPage() }} 页。
我发现，很多时候开发者会直接在前端通过循环
$posts来获取数据，而忽略了这些方便的元信息方法。其实它们才是分页的核心价值之一，能让你更精准地展示分页状态。
Laravel分页在API接口中如何处理和前端交互？
在API接口中处理分页，跟传统的Web页面渲染有所不同。我们通常会返回JSON格式的数据，而不是渲染HTML。Laravel的分页器对象在被转换为JSON时，会自动包含所有必要的元数据和链接，这简直是为API量身定做的。
当你从控制器返回一个分页器实例时，Laravel会自动将其序列化为JSON。一个典型的JSON响应结构会是这样：
{
"data": [
{ /* post 1 */ },
{ /* post 2 */ },
// ... 当前页的文章数据
],
"links": {
"first": "http://example.com/api/posts?page=1",
"last": "http://example.com/api/posts?page=5",
"prev": null, // 或前一页的URL
"next": "http://example.com/api/posts?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 5,
"path": "http://example.com/api/posts",
"per_page": 15,
"to": 15,
"total": 70
}
}在控制器里，你只需要：
use Illuminate\Http\Request;
use App\Models\Post;
public function index(Request $request)
{
$perPage = $request->input('per_page', 15);
$posts = Post::query()->paginate($perPage);
// Laravel会自动将Paginator实例序列化为上述JSON结构
return response()->json($posts);
}前端（比如用Vue、React或原生JS）拿到这个JSON后，就可以很方便地解析：
response.data
：就是当前页的文章列表，可以直接用来渲染。response.meta.current_page
：当前页码。response.meta.total
：总文章数。response.links.next
、response.links.prev
：可以直接用来构建“下一页”、“上一页”按钮的请求URL。
我个人觉得，这种设计非常优雅，把后端分页的复杂性很好地封装起来，前端只需要关注数据和导航链接就行。不需要前端再自己去拼凑分页URL或者计算总页数，大大简化了前后端协作。当然，如果你觉得默认的JSON结构不完全符合你的需求，也可以通过资源（Resource）来进一步定制输出格式，但那是另一个话题了。
