如何在PHP中实现RESTful API的分页和筛选

在Web开发中，RESTful API是非常流行的一种API设计风格，它通过对资源进行统一的URL地址映射和HTTP动词操作，来实现对数据的增删改查。在实际应用中，可能会遇到需要分页和筛选数据的情况。本文将介绍如何在PHP中实现RESTful API的分页和筛选功能。

1. 分页

1.1 前端请求传参

在前端页面中，需要传递当前页数和每页显示的数据条数，可以通过GET方法传递两个参数，如下所示：

http://example.com/api/users?page=1&limit=10

其中，`page`表示当前页数，`limit`表示每页显示的数据条数。

1.2 后台处理数据

在后台处理数据时，需要先获取前端传递过来的两个参数，然后根据参数进行查询和返回结果。可以使用PHP中的`$_GET`全局变量来获取参数值。示例代码如下：

$page = isset($_GET['page']) ? intval($_GET['page']) : 1;

$limit = isset($_GET['limit']) ? intval($_GET['limit']) : 10;

这里使用`intval`函数将参数值转换成整型，以确保安全性和正确性。

接下来，可以使用SQL语句进行查询，并计算数据总条数和总页数。示例代码如下：

$start = ($page - 1) * $limit; // 计算起始位置

$sql = "SELECT * FROM `users` LIMIT {$start}, {$limit}";
$res = mysqli_query($conn, $sql);
// 计算数据总条数和总页数
$count_sql = "SELECT COUNT(*) FROM `users`";
$count_res = mysqli_query($conn, $count_sql);
$count_row = mysqli_fetch_row($count_res);
$count = $count_row[0];
$total_pages = ceil($count / $limit);

这里使用`mysqli_query`函数执行SQL语句，通过`mysqli_fetch_row`函数获取查询结果数组中的第一行第一列的值，即数据总条数。然后使用`ceil`函数将数据总条数除以每页显示的数据条数进行向上取整，得到总页数。

最后，将查询结果和总页数封装成数组返回给前端即可。示例代码如下：

$result = array();

while ($row = mysqli_fetch_assoc($res)) {
    $result[] = $row;
}
$response = array(
    'data' => $result,
    'total_pages' => $total_pages
);
echo json_encode($response);

这里将查询结果和总页数封装成了一个关联数组，并使用`json_encode`函数将其转为JSON字符串返回给前端。

2. 筛选

2.1 前端请求传参

在前端页面中，需要传递一些条件来进行数据筛选，可以通过GET方法传递参数，如下所示：

http://example.com/api/users?gender=male&age=20+

其中，`gender`和`age`表示筛选条件，`male`和`20+`是具体的条件值。

2.2 后台处理数据

在后台处理数据时，需要先获取前端传递过来的参数，并将其作为SQL语句的查询条件。可以使用PHP中的`$_GET`全局变量来获取参数值。示例代码如下：

$gender = isset($_GET['gender']) ? mysqli_real_escape_string($conn, $_GET['gender']) : '';

$age = isset($_GET['age']) ? mysqli_real_escape_string($conn, $_GET['age']) : '';
$where = array();
if ($gender != '') {
    $where[] = "gender = '{$gender}'";
}
if ($age != '') {
    if (strpos($age, '+') !== false) {
        $age_val = str_replace('+', '', $age);
        $where[] = "age >= '{$age_val}'";
    } else {
        $age_vals = explode('-', $age);
        $where[] = "age >= '{$age_vals[0]}' AND age <= '{$age_vals[1]}'";
    }
}
$where_sql = '';
if (!empty($where)) {
    $where_sql = 'WHERE ' . implode(' AND ', $where);
}
$sql = "SELECT * FROM `users` {$where_sql}";
$res = mysqli_query($conn, $sql);

这里将获取的参数值使用`mysqli_real_escape_string`函数进行了转义，以防SQL注入攻击。然后根据参数值拼接查询条件，并使用`implode`函数将条件数组中的每个元素用AND拼接成一个字符串。

最后，将查询结果封装成数组返回给前端即可。示例代码如下：

$result = array();

while ($row = mysqli_fetch_assoc($res)) {
    $result[] = $row;
}
echo json_encode($result);

这里直接将查询结果转为JSON字符串返回给前端。

3. 总结

使用PHP实现RESTful API的分页和筛选功能，可以方便地处理大量数据，并提高用户体验。在实现过程中，需要注意参数的安全性和正确性，以及SQL注入攻击的防范。通过本文的介绍，相信读者已经掌握了相应的技能，可以在自己的项目中进行应用。