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

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

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

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

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

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

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

<?php

// 数据库连接配置
$host = 'localhost';
$db   = 'your_database';
$user = 'your_user';
$pass = 'your_password';
$charset = 'utf8mb4';

$dsn = "mysql:host=$host;dbname=$db;charset=$charset";
$options = [
    PDO::ATTR_ERRMODE            => 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 "<h1>数据列表</h1>";
echo "<pre>";
print_r($data); // 假设这里是你的数据展示
echo "</pre>";

echo "<div class='pagination'>";
// 上一页链接
if ($currentPage > 1) {
    echo "<a href='?page=" . ($currentPage - 1) . "'>上一页</a> ";
}

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

if ($startPage > 1) {
    echo "<a href='?page=1'>1</a> ";
    if ($startPage > 2) {
        echo "... ";
    }
}

for ($i = $startPage; $i <= $endPage; $i++) {
    if ($i == $currentPage) {
        echo "<span class='current-page'>$i</span> ";
    } else {
        echo "<a href='?page=$i'>$i</a> ";
    }
}

if ($endPage < $totalPages) {
    if ($endPage < $totalPages - 1) {
        echo "... ";
    }
    echo "<a href='?page=$totalPages'>$totalPages</a> ";
}

// 下一页链接
if ($currentPage < $totalPages) {
    echo "<a href='?page=" . ($currentPage + 1) . "'>下一页</a> ";
}
echo "</div>";

?>

这段代码展示了一个相对完整的流程。它处理了页码边界情况，比如当前页小于1或大于总页数，也考虑了没有数据时的特殊情况。分页链接的生成也做了一点小优化，只显示当前页附近的一些页码，避免页码过多导致界面混乱。

PHP分页中常见的性能陷阱与优化策略有哪些？

在实际项目中，分页功能可不是简单地

LIMIT
一下就完事了，特别是当数据量达到百万甚至千万级别时，性能问题会立刻浮现。我记得有一次，我们一个老系统在用户列表分页时，翻到几百页后响应时间直接飙升到几十秒，简直是灾难。

最常见的性能陷阱就是

LIMIT offset, count
中的
offset
过大。MySQL在处理
LIMIT offset, count
时，即使你只取
count
条记录，它也可能需要扫描并跳过
offset
条记录，然后才开始返回结果。这个“跳过”的过程，对于索引良好的小表还好，但对于大表来说，随着
offset
的增大，性能会线性下降，甚至更糟。数据库不得不读取大量它最终会丢弃的数据，这无疑是巨大的资源浪费。

针对这个问题，有几种优化策略可以考虑：

  1. 基于游标（Cursor-based）或“上次ID”的分页： 这是我个人非常推崇的一种方式，尤其适用于“下一页”或无限滚动加载的场景。它的核心思想是：不使用

    offset
    ，而是记录当前页的最后一条记录的某个唯一标识（比如ID或时间戳）。下一页的查询就变成
    SELECT * FROM your_table WHERE id > last_id ORDER BY id ASC LIMIT count
    。这样数据库可以直接利用索引定位到
    last_id
    之后的数据，避免了扫描大量无用记录。缺点是不能直接跳到任意页，但对于很多业务场景来说，这反而是更自然的用户体验。

  2. *优化`COUNT()

    查询：** 计算总记录数
    COUNT(*)`在大表上同样可能很慢，因为它需要扫描整个表（或索引）。
    • 缓存总记录数： 如果数据更新不频繁，可以将总记录数缓存起来（例如使用Redis或Memcached），设置一个合理的过期时间。
    • 近似计数： 对于一些不需要精确总数的场景，可以考虑使用近似计数。例如，
      EXPLAIN SELECT COUNT(*) FROM your_table
      可以给出一个近似的行数，或者使用数据库的统计信息。但这个通常不推荐用于用户可见的分页。
    • 分段计数： 如果表非常大，可以考虑将
      COUNT(*)
      操作拆分到从表中获取（如果你的业务允许）。

  3. 合理使用索引： 确保你的

    ORDER BY
    子句中使用的列以及
    WHERE
    子句中使用的列都有合适的索引。这是数据库性能优化的基石。例如，如果你的分页总是按
    id
    排序，那么
    id
    列上的主键索引就至关重要。

  4. *避免`SELECT 

    ：** 只选择你需要的列，而不是
    SELECT *`。这可以减少网络传输和数据库I/O的开销。

  5. 数据库层面的分区（Partitioning）： 对于超大型表，可以考虑在数据库层面进行分区。将数据分散到不同的物理存储中，查询时可以只扫描相关的分区，从而提高性能。但这属于比较高级的优化手段，需要仔细规划。

总的来说，分页优化是一个权衡的过程，没有银弹。根据你的数据量、查询模式和业务需求，选择最适合的策略才是王道。

如何在PHP框架（如Laravel或Symfony）中集成和自定义分页功能？

说实话，现代PHP框架在分页这块做得非常出色，它们把底层的复杂逻辑封装得很好，让我们开发者可以把更多精力放在业务逻辑上，而不是重复造轮子。这确实大大提升了开发效率。

以我最熟悉的Laravel为例，它的分页功能简直是开箱即用，非常优雅。

Laravel中的集成：

在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 }} <br>
@endforeach

<div class="mt-4">
    {{ $posts->links() }}
</div>

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 }} <br>
{% endfor %}

<div class="navigation">
    {{ knp_pagination_render(pagination) }}
</div>

自定义框架分页：

框架提供的高度抽象并不意味着我们不能自定义。

  1. 自定义视图/模板：

    • Laravel： 你可以发布分页视图并修改它们。运行
      php artisan vendor:publish --tag=laravel-pagination
      ，然后你就可以在
      resources/views/vendor/pagination
      目录下找到默认的分页模板，并根据你的UI/UX需求进行修改。
    • Symfony (KnpPaginatorBundle)： 同样，它允许你配置使用自定义的Twig模板来渲染分页链接，通过在
      config/packages/knp_paginator.yaml
      中指定。

  2. 自定义URL参数：

    • Laravel： 
      withQueryString()
      方法可以保留所有现有的查询字符串参数。如果你想改变分页参数名（默认是
      page
      ），可以使用
      appends()
      方法或在
      AppServiceProvider
      中配置。
    • Symfony (KnpPaginatorBundle)： 
      paginate()
      方法的第三个参数可以传递额外的URL参数，或者通过配置来改变页码参数名。

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

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

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

以上就是php如何实现分页功能_php分页查询代码示例的详细内容，更多请关注知识资源分享宝库其它相关文章！

标签:  分页 示例 如何实现 

相关阅读

发表评论:

◎欢迎参与讨论，请在这里发表您的看法、交流您的观点。

最近发表

标签列表