php如何实现分页功能_php分页查询代码示例

裘德小鎮的故事

发布时间：2025-08-29 13:51:01

593人浏览过

来源于php中文网

原创

答案：PHP分页通过SQL的LIMIT和OFFSET控制数据范围，结合总记录数计算页码，使用PDO实现安全查询，并生成分页链接；优化时可采用游标分页、索引优化、缓存总数等策略提升性能；现代框架如Laravel和Symfony封装了分页逻辑，支持快速集成与自定义。

php如何实现分页功能_php分页查询代码示例

PHP实现分页功能，核心在于利用SQL的

LIMIT

子句来限制查询结果的数量和起始位置，并结合总记录数的计算来构建分页导航。这听起来可能有点抽象，但说白了，就是告诉数据库“我想要从第X条记录开始，给我Y条记录”，同时我们自己得知道总共有多少条记录，才能算出总页数，进而生成“上一页”、“下一页”以及具体的页码链接。

解决方案

要实现PHP分页，我们需要几个关键信息：当前页码、每页显示的记录数，以及总记录数。有了这些，我们就能计算出偏移量（OFFSET）和总页数，然后构造SQL查询，并生成用户友好的分页链接。

我个人觉得，一个好的分页实现，不仅要功能完整，代码也要清晰可维护。下面是一个基于PDO的简单实现，涵盖了从数据库查询到前端分页链接生成的基本流程。

 PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES   => false,
];

try {
    $pdo = new PDO($dsn, $user, $pass, $options);
} catch (\PDOException $e) {
    throw new \PDOException($e->getMessage(), (int)$e->getCode());
}

// 1. 定义每页显示的记录数
$recordsPerPage = 10;

// 2. 获取当前页码
// 检查URL中是否有'page'参数，如果没有，默认为第一页
$currentPage = isset($_GET['page']) && is_numeric($_GET['page']) ? (int)$_GET['page'] : 1;
// 确保页码不小于1
if ($currentPage < 1) {
    $currentPage = 1;
}

// 3. 查询总记录数
$stmt = $pdo->query("SELECT COUNT(*) FROM your_table");
$totalRecords = $stmt->fetchColumn();

// 4. 计算总页数
$totalPages = ceil($totalRecords / $recordsPerPage);

// 确保当前页码不超过总页数
if ($currentPage > $totalPages && $totalPages > 0) {
    $currentPage = $totalPages;
} elseif ($totalPages == 0) { // 如果没有记录，当前页就是0
    $currentPage = 0;
}


// 5. 计算SQL查询的偏移量 (OFFSET)
// OFFSET = (当前页码 - 1) * 每页记录数
$offset = ($currentPage - 1) * $recordsPerPage;
if ($offset < 0) $offset = 0; // 防止负数偏移量

// 6. 查询当前页的数据
$stmt = $pdo->prepare("SELECT * FROM your_table ORDER BY id DESC LIMIT :offset, :recordsPerPage");
$stmt->bindParam(':offset', $offset, PDO::PARAM_INT);
$stmt->bindParam(':recordsPerPage', $recordsPerPage, PDO::PARAM_INT);
$stmt->execute();
$data = $stmt->fetchAll();

// 7. 生成分页导航链接
echo "数据列表";
echo "";
print_r($data); // 假设这里是你的数据展示
echo "";

echo "";
// 上一页链接
if ($currentPage > 1) {
    echo "上一页 ";
}

// 页码链接
$startPage = max(1, $currentPage - 2);
$endPage = min($totalPages, $currentPage + 2);

if ($startPage > 1) {
    echo "1 ";
    if ($startPage > 2) {
        echo "... ";
    }
}

for ($i = $startPage; $i $i ";
    } else {
        echo "$i ";
    }
}

if ($endPage $totalPages ";
}

// 下一页链接
if ($currentPage 下一页 ";
}
echo "";

?>这段代码展示了一个相对完整的流程。它处理了页码边界情况，比如当前页小于1或大于总页数，也考虑了没有数据时的特殊情况。分页链接的生成也做了一点小优化，只显示当前页附近的一些页码，避免页码过多导致界面混乱。
立即学习“PHP免费学习笔记（深入）”；
PHP分页中常见的性能陷阱与优化策略有哪些？
在实际项目中，分页功能可不是简单地
LIMIT
一下就完事了，特别是当数据量达到百万甚至千万级别时，性能问题会立刻浮现。我记得有一次，我们一个老系统在用户列表分页时，翻到几百页后响应时间直接飙升到几十秒，简直是灾难。
最常见的性能陷阱就是
LIMIT offset, count
中的offset
过大。MySQL在处理LIMIT offset, count
时，即使你只取count
条记录，它也可能需要扫描并跳过offset
条记录，然后才开始返回结果。这个“跳过”的过程，对于索引良好的小表还好，但对于大表来说，随着offset
的增大，性能会线性下降，甚至更糟。数据库不得不读取大量它最终会丢弃的数据，这无疑是巨大的资源浪费。
针对这个问题，有几种优化策略可以考虑：

基于游标（Cursor-based）或“上次ID”的分页：
这是我个人非常推崇的一种方式，尤其适用于“下一页”或无限滚动加载的场景。它的核心思想是：不使用
offset
，而是记录当前页的最后一条记录的某个唯一标识（比如ID或时间戳）。下一页的查询就变成SELECT * FROM your_table WHERE id > last_id ORDER BY id ASC LIMIT count
。这样数据库可以直接利用索引定位到last_id
之后的数据，避免了扫描大量无用记录。缺点是不能直接跳到任意页，但对于很多业务场景来说，这反而是更自然的用户体验。

*优化`COUNT()
查询：** 计算总记录数
COUNT(*)`在大表上同样可能很慢，因为它需要扫描整个表（或索引）。


缓存总记录数： 如果数据更新不频繁，可以将总记录数缓存起来（例如使用Redis或Memcached），设置一个合理的过期时间。

近似计数： 对于一些不需要精确总数的场景，可以考虑使用近似计数。例如，EXPLAIN SELECT COUNT(*) FROM your_table
可以给出一个近似的行数，或者使用数据库的统计信息。但这个通常不推荐用于用户可见的分页。

分段计数： 如果表非常大，可以考虑将COUNT(*)
操作拆分到从表中获取（如果你的业务允许）。


合理使用索引：
确保你的
ORDER BY
子句中使用的列以及WHERE
子句中使用的列都有合适的索引。这是数据库性能优化的基石。例如，如果你的分页总是按id
排序，那么id
列上的主键索引就至关重要。
*避免`SELECT 
：** 只选择你需要的列，而不是
SELECT *`。这可以减少网络传输和数据库I/O的开销。
数据库层面的分区（Partitioning）：
对于超大型表，可以考虑在数据库层面进行分区。将数据分散到不同的物理存储中，查询时可以只扫描相关的分区，从而提高性能。但这属于比较高级的优化手段，需要仔细规划。

总的来说，分页优化是一个权衡的过程，没有银弹。根据你的数据量、查询模式和业务需求，选择最适合的策略才是王道。
如何在PHP框架（如Laravel或Symfony）中集成和自定义分页功能？
说实话，现代PHP框架在分页这块做得非常出色，它们把底层的复杂逻辑封装得很好，让我们开发者可以把更多精力放在业务逻辑上，而不是重复造轮子。这确实大大提升了开发效率。
以我最熟悉的Laravel为例，它的分页功能简直是开箱即用，非常优雅。
Laravel中的集成：

							
								
								
									知了追踪
									AI智能信息助手，智能追踪你的兴趣资讯
								
								下载 
							
						
在Laravel中，你几乎不需要写任何SQL的
LIMIT
和offset
。Eloquent ORM（或查询构建器）提供了paginate()
方法。
// app/Http/Controllers/PostController.php

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

class PostController extends Controller
{
    public function index()
    {
        // 每页显示15条记录
        $posts = Post::paginate(15);

        // 也可以这样，从请求中获取每页数量
        // $posts = Post::paginate(request('per_page', 15));

        return view('posts.index', ['posts' => $posts]);
    }
}
在你的Blade视图中，你只需要简单地调用
links()
方法来渲染分页链接：
{{-- resources/views/posts/index.blade.php --}}

@foreach ($posts as $post)
    {{ $post->title }} 

@endforeach


    {{ $posts->links() }}
Laravel会自动处理当前页码的获取（通常是
?page=X
），总记录数，以及生成带“上一页”、“下一页”和页码的HTML链接。这背后其实也是用的LIMIT
和offset
，但框架帮你管理了所有细节。
Symfony中的集成：
Symfony通常会结合KnpPaginatorBundle来提供分页功能。虽然不如Laravel内置那么“无缝”，但功能同样强大且灵活。
首先，你需要安装KnpPaginatorBundle：
composer require knplabs/knp-paginator-bundle
然后在你的控制器中：
// src/Controller/ArticleController.php

namespace App\Controller;

use App\Entity\Article;
use Doctrine\ORM\EntityManagerInterface;
use Knp\Component\Pager\PaginatorInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class ArticleController extends AbstractController
{
    #[Route('/articles', name: 'app_articles')]
    public function index(
        Request $request,
        EntityManagerInterface $entityManager,
        PaginatorInterface $paginator
    ): Response {
        $queryBuilder = $entityManager->getRepository(Article::class)->createQueryBuilder('a');

        $pagination = $paginator->paginate(
            $queryBuilder->getQuery(), /* query NOT result */
            $request->query->getInt('page', 1), /* current page number */
            10 /* limit per page */
        );

        return $this->render('articles/index.html.twig', [
            'pagination' => $pagination,
        ]);
    }
}
在Twig模板中渲染分页：
{# templates/articles/index.html.twig #}

{% for article in pagination %}
    {{ article.title }} 

{% endfor %}


    {{ knp_pagination_render(pagination) }}
自定义框架分页：
框架提供的高度抽象并不意味着我们不能自定义。


自定义视图/模板：


Laravel： 你可以发布分页视图并修改它们。运行php artisan vendor:publish --tag=laravel-pagination
，然后你就可以在resources/views/vendor/pagination
目录下找到默认的分页模板，并根据你的UI/UX需求进行修改。

Symfony (KnpPaginatorBundle)： 同样，它允许你配置使用自定义的Twig模板来渲染分页链接，通过在config/packages/knp_paginator.yaml
中指定。



自定义URL参数：


Laravel： withQueryString()
方法可以保留所有现有的查询字符串参数。如果你想改变分页参数名（默认是page
），可以使用appends()
方法或在AppServiceProvider
中配置。

Symfony (KnpPaginatorBundle)： paginate()
方法的第三个参数可以传递额外的URL参数，或者通过配置来改变页码参数名。



AJAX分页：
无论哪个框架，实现AJAX分页的核心都是：

前端通过JavaScript监听分页链接的点击事件。
阻止默认的链接跳转行为。
使用fetch
或axios
等发送AJAX请求到后端，带上新的页码。
后端控制器返回只包含新页数据的JSON或部分HTML。
前端接收响应，更新页面内容（例如，替换列表区域的HTML）。
框架的分页器对象通常会提供方法来获取当前页的数据，非常适合这种场景。



框架的分页功能，在我看来，是它们提供给开发者最有价值的抽象之一。它不仅简化了代码，还提升了代码的一致性和可维护性，让我们可以更专注于创造性的工作。