
本文介绍如何将传统的 php 分页链接改造为 ajax 驱动的无刷新分页,使其在 wordpress 前端调用中保持当前页面上下文,同时安全传递搜索条件(如日期范围、关键词)并避免 sql 注入风险。
本文介绍如何将传统的 php 分页链接改造为 ajax 驱动的无刷新分页,使其在 wordpress 前端调用中保持当前页面上下文,同时安全传递搜索条件(如日期范围、关键词)并避免 sql 注入风险。
在 WordPress 自定义模板中通过 AJAX 加载 PHP 后端数据(如 /api2/allrecords.php)时,常见的痛点是:分页按钮仍使用 <a href="...?page=N"></a> 形式,导致整个页面跳转,丢失当前搜索状态与前端布局。根本原因在于:GET 分页请求无法携带原始 POST 提交的搜索参数(from_date/to_date/search),且直接拼接用户输入到 SQL 中存在严重安全漏洞。
✅ 正确方案:AJAX 分页 + 参数持久化 + 预处理
需同时改造 前端按钮行为 和 后端数据处理逻辑,确保分页请求能复用初始搜索条件:
1. 前端:禁用默认跳转,改用 JavaScript 触发 AJAX 请求
将原生 <a href="..."></a> 替换为 href="#" + onclick 调用封装函数,并通过 base64_encode 安全传递已有的 POST 参数(防止 HTML 特殊字符破坏 JS 字符串):
<script type="text/javascript">
function gotoPage(page) {
// 从 PHP 注入的 base64 编码值中还原搜索参数
const from_date = atob("<?php echo base64_encode($_POST['from_date'] ?? ''); ?>");
const to_date = atob("<?php echo base64_encode($_POST['to_date'] ?? ''); ?>");
const search = atob("<?php echo base64_encode($_POST['search'] ?? ''); ?>");
$.ajax({
url: "/api2/allrecords.php?page=" + page,
method: "POST",
data: { from_date, to_date, search },
success: function(data) {
$('#rvoucher').html(data); // 仅刷新表格区域
},
error: function() {
alert("分页加载失败,请检查网络或重试");
}
});
}
</script>
<!-- 生成无跳转分页按钮 -->
<?php
if ($page > 1) {
echo '<a href="#" onclick="gotoPage(' . ($page - 1) . ')" class="btn btn-danger">Previous</a>';
}
for ($i = 1; $i <= $total_page; $i++) { // 注意:此处应为 <= $total_page
$active = ($i == $page) ? ' active' : '';
echo '<a href="#" onclick="gotoPage(' . $i . ')" class="btn btn-primary' . $active . '">' . $i . '</a>';
}
if ($page < $total_page) {
echo '<a href="#" onclick="gotoPage(' . ($page + 1) . ')" class="btn btn-danger">Next</a>';
}
?>⚠️ 注意:原代码中
for($i=1;$i 会漏掉最后一页;应改为 <code>。
2. 后端:强化参数校验与 SQL 安全防护
在 allrecords.php 中,必须 使用预处理语句替代字符串拼接,并统一处理分页与搜索逻辑:
// 1. 获取并过滤所有参数(含分页)
$page = (int)($_GET['page'] ?? 1);
$page = max(1, $page);
$from_date = filter_input(INPUT_POST, 'from_date', FILTER_SANITIZE_STRING) ?: '';
$to_date = filter_input(INPUT_POST, 'to_date', FILTER_SANITIZE_STRING) ?: '';
$search = filter_input(INPUT_POST, 'search', FILTER_SANITIZE_STRING) ?: '';
// 2. 构建安全的 WHERE 条件(使用 PDO 或 mysqli 预处理)
$conditions = [];
$params = [];
$types = '';
if (!empty($from_date)) {
$conditions[] = "date_column >= ?";
$params[] = $from_date;
$types .= 's';
}
if (!empty($to_date)) {
$conditions[] = "date_column <= ?";
$params[] = $to_date;
$types .= 's';
}
if (!empty($search)) {
$conditions[] = "name LIKE ?";
$params[] = "%{$search}%";
$types .= 's';
}
$where_clause = !empty($conditions) ? 'WHERE ' . implode(' AND ', $conditions) : '';
$sql_count = "SELECT COUNT(*) FROM rvtable {$where_clause}";
$sql_data = "SELECT * FROM rvtable {$where_clause} LIMIT ?, ?";
// 3. 使用 mysqli 预处理(示例)
$connect = new mysqli("127.0.0.1", "crudDBck69t", "NTCHilrXdf", "crudDBck69t");
$stmt = $connect->prepare($sql_count);
if (!empty($params)) $stmt->bind_param($types, ...$params);
$stmt->execute();
$total_record = (int)$stmt->get_result()->fetch_row()[0];
$num_per_page = 20;
$start_from = ($page - 1) * $num_per_page;
$total_page = ceil($total_record / $num_per_page);
// 查询数据
$stmt = $connect->prepare($sql_data);
$all_params = array_merge($params, [$start_from, $num_per_page]);
$types_with_limits = $types . 'ii';
$stmt->bind_param($types_with_limits, ...$all_params);
$stmt->execute();
$result = $stmt->get_result();
// 输出表格 HTML(略)...3. 关键注意事项
- ✅ 不要在 URL 中暴露敏感参数:
base64_encode仅用于 JS 字符串转义,非加密;真实业务中建议将搜索条件存入session或前端localStorage。 - ✅ 始终校验分页参数:
$page必须强制转为整数并限制范围(如max(1, min($page, $total_page))),防止越界访问。 - ✅ SQL 注入零容忍:
$_POST/$_GET数据绝不可直接拼入 SQL;务必使用mysqli::prepare()或 PDO 预处理。 - ✅ WordPress 环境兼容性:确保
/api2/allrecords.php不依赖 WordPress 核心函数(如get_option()),否则需手动引入wp-load.php—— 更推荐将其重构为 WordPress REST API endpoint。
通过以上改造,分页按钮将完全脱离页面跳转,实现平滑的局部刷新体验,同时兼顾安全性与可维护性。

















