PHP分页功能失效求助：搜索引擎集成分页代码遇问题

架构老林

2026-5-27

嘿，我看到你在把PHP分页功能集成到搜索引擎时碰钉子了，而且你贴的代码还没写完（结尾截断了）。不过没关系，我先从分页失效的常见坑点入手，帮你排查问题，再给你一套修复后的完整代码～

先说说分页失效的常见原因&修复办法

1. 页码参数没处理好
很多时候是没正确获取page参数，或者没给默认值，导致每次翻页都回到第一页。修复起来很简单：给页码设个默认值1，还要确保它是整数，防止非法输入。
代码示例：$page = isset($_GET['page']) ? max(1, (int)$_GET['page']) : 1;
2. 搜索关键词没跟着分页链接走
翻页的时候如果分页链接里不带search参数，那新页面就丢了搜索条件，自然显示的不是你要的结果。修复：所有分页链接都要带上搜索关键词，记得用urlencode()转义特殊字符。
比如上一页链接：<a href="?search=<?php echo urlencode($search); ?>&page=<?php echo $page-1; ?>">上一页</a>
3. 偏移量算错了
分页的核心偏移量公式是($page - 1) * 每页条数，要是写成$page * 每页条数，就会跳过第一页的内容，或者重复显示。一定要严格按公式来！
4. 总条数查询和搜索条件不匹配
总条数的SQL必须和分页查询的WHERE条件一致，不然会出现“明明有10条结果，分页却显示只有2页”的情况。比如搜索时，总条数要基于搜索后的结果数，不是全表总数。
5. SQLite3查询执行出问题
比如没正确调用query()或者querySingle()获取结果，或者没处理空结果的情况。要确保每个查询都正确执行，并且结果集能正常遍历。

修复后的完整代码示例

下面是一套完整的、能正常运行的搜索+分页代码，你可以直接套用到你的项目里：

<?php
// 初始化SQLite3数据库连接（替换成你的数据库路径）
$db = new SQLite3('your_search_db.db');

// 处理搜索和分页参数
$search = isset($_GET['search']) ? trim($_GET['search']) : '';
// 确保页码是正整数，默认显示第一页
$page = isset($_GET['page']) ? max(1, (int)$_GET['page']) : 1;
$per_page = 10; // 每页显示10条结果，可按需调整

// 构建搜索条件
$condition = '1=1'; // 默认显示全表内容
if (!empty($search)) {
    $query_terms = explode(" ", $search);
    $like_clauses = [];
    foreach ($query_terms as $term) {
        // 转义特殊字符，防止SQL注入
        $escaped_term = SQLite3::escapeString($term);
        $like_clauses[] = "(question LIKE '%$escaped_term%' OR answer LIKE '%$escaped_term%')";
    }
    // 把多个关键词的条件用OR拼接
    $condition = implode(' OR ', $like_clauses);
}

// 查询符合条件的总条数，用于计算总页数
$count_sql = "SELECT COUNT(*) AS total FROM your_table WHERE $condition";
$total_items = $db->querySingle($count_sql);
$total_pages = ceil($total_items / $per_page);

// 计算分页偏移量
$offset = ($page - 1) * $per_page;

// 执行分页查询
$data_sql = "SELECT * FROM your_table WHERE $condition LIMIT $per_page OFFSET $offset";
$result = $db->query($data_sql);

// 显示搜索结果
if ($total_items > 0) {
    while ($row = $result->fetchArray(SQLITE3_ASSOC)) {
        // 用htmlspecialchars转义内容，防止XSS攻击
        echo "<div class='result-item'>";
        echo "<h4>" . htmlspecialchars($row['question']) . "</h4>";
        echo "<p>" . htmlspecialchars($row['answer']) . "</p>";
        echo "</div>";
    }

    // 显示分页导航栏
    echo "<div class='pagination'>";
    // 上一页按钮
    if ($page > 1) {
        $prev_page = $page - 1;
        echo "<a href='?search=" . urlencode($search) . "&page=$prev_page'>&laquo; 上一页</a>";
    }

    // 页码列表
    for ($i = 1; $i <= $total_pages; $i++) {
        $active_class = ($i == $page) ? 'class="active"' : '';
        echo "<a href='?search=" . urlencode($search) . "&page=$i' $active_class>$i</a>";
    }

    // 下一页按钮
    if ($page < $total_pages) {
        $next_page = $page + 1;
        echo "<a href='?search=" . urlencode($search) . "&page=$next_page'>下一页 &raquo;</a>";
    }
    echo "</div>";
} else {
    echo "<p>抱歉，没有找到匹配的搜索结果</p>";
}

// 关闭数据库连接
$db->close();
?>

额外提醒

安全性：虽然用了SQLite3::escapeString()，但更推荐用预处理语句（prepare() + bindValue()）来进一步防范SQL注入，尤其是处理用户输入的时候。
用户体验：可以给当前页码加个样式（比如高亮），让用户知道自己在第几页。
边界处理：当页码小于1或者大于总页数时，要跳转到第一页或者最后一页，避免出现空白页面。

内容的提问来源于stack exchange，提问作者diagold