PHP分页优化：解决非法页码引发的SQL错误与空白页问题

问题背景 #

现有PHP分页脚本支持搜索查询，但存在以下问题：

• 传入负页码（如page=-5）会触发SQL错误
• 传入超出总页数的页码（如总页数10时传page=11）会显示空白页
• 尝试的重定向代码在无记录/查询无结果时会陷入循环

解决方案 #

核心逻辑是先处理无记录场景，再修正页码合法性，最后用标准HTTP头实现重定向（比JS/meta刷新更可靠）。

步骤1：初始化与计数查询优化 #

先将页码强制转为整数，再处理记录计数，避免非数字输入干扰：

$query = (!empty($_GET['q'])) ? trim($_GET['q']) : '';

// 强制转为整数，过滤非数字页码
$current_page = isset($_GET['page']) ? (int)$_GET['page'] : 1;

define('registers_pp', 100);
define('pages_range', 5);

// 执行计数查询
if (empty($query)) {
    $countUserUser = '执行统计全部记录的SQL'; // 替换为实际计数查询逻辑
} else {
    $countUserUser = '执行统计搜索结果的SQL'; // 替换为实际计数查询逻辑
}

// 兼容无记录场景，默认总记录数为0
$total_records = $countUserUser->total ?? 0;
// 无记录时last_page设为1，避免后续逻辑出错
$last_page = $total_records > 0 ? ceil($total_records / registers_pp) : 1;

步骤2：非法页码处理与安全重定向 #

用header()实现HTTP 302重定向，同时规避无记录时的循环：

// 无记录场景：直接跳转到不带页码的URL（或page=1），避免循环
if ($total_records === 0) {
    $redirect_params = [
        'q' => $query,
        'order' => $current_order ?? '',
        'field' => $current_field ?? ''
    ];
    // 过滤空参数，避免URL出现多余的&符号
    $redirect_params = array_filter($redirect_params);
    $redirect_url = '/user?' . http_build_query($redirect_params);
    
    header("Location: $redirect_url", true, 302);
    exit;
}

// 负页码/0页码：重定向到page=1
if ($current_page < 1) {
    $redirect_params = [
        'q' => $query,
        'order' => $current_order ?? '',
        'field' => $current_field ?? '',
        'page' => 1
    ];
    $redirect_url = '/user?' . http_build_query($redirect_params);
    
    header("Location: $redirect_url", true, 302);
    exit;
}

// 超出总页数：重定向到最后一页
if ($current_page > $last_page) {
    $redirect_params = [
        'q' => $query,
        'order' => $current_order ?? '',
        'field' => $current_field ?? '',
        'page' => $last_page
    ];
    $redirect_url = '/user?' . http_build_query($redirect_params);
    
    header("Location: $redirect_url", true, 302);
    exit;
}

步骤3：执行合法数据查询 #

此时页码已确保合法，可安全执行数据查询：

$initial_line = ($current_page - 1) * registers_pp;

if (empty($query)) {
    $dataUserUser = '执行获取全部用户数据的SQL，带LIMIT ' . $initial_line . ', ' . registers_pp;
} else {
    $dataUserUser = '执行获取搜索用户数据的SQL，带LIMIT ' . $initial_line . ', ' . registers_pp;
}

// 分页导航逻辑保持不变
$first_page    = 1;
$previous_page = ($current_page > 1) ? $current_page - 1 : 0;
$next_page     = ($current_page < $last_page) ? $current_page + 1 : 0;
$initial_range = (($current_page - pages_range) >= 1) ? $current_page - pages_range : 1;
$final_range   = (($current_page + pages_range) <= $last_page ) ? $current_page + pages_range : $last_page;

关键优化点 #

• 用(int)强制转换页码为整数，彻底过滤非数字输入
• 优先处理无记录场景，避免重定向循环
• 使用http_build_query()构建URL，自动处理参数编码与拼接，避免手动拼接的错误
• 用HTTP头重定向替代JS/meta刷新，符合HTTP规范，且不受JS禁用影响

内容的提问来源于stack exchange，提问作者kold-kreator