如何利用 mysqli_result 实现后端搜索建议接口

M66 2025-05-28

在现代的网页开发中，搜索功能是一个非常重要的组件。为了提高用户体验，很多网站在搜索框下方都会显示一些搜索建议，帮助用户更快速地找到他们想要的信息。这篇文章将通过一个简单的例子，展示如何使用 PHP 和 mysqli_result 函数实现一个后端搜索建议接口功能。

1. 数据库连接

首先，我们需要连接到数据库。以下是用 PHP 的 mysqli 扩展来进行连接的代码：

<?php
$host = "localhost";
$username = "root";
$password = "yourpassword";
$database = "yourdatabase";

$conn = new mysqli($host, $username, $password, $database);

// 检查连接
if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}
?>

这段代码会连接到数据库服务器，并选择一个数据库来执行后续的查询。

2. 创建搜索建议接口

我们将创建一个简单的搜索建议接口，允许用户输入关键字，后端返回符合条件的建议列表。以下是实现这个功能的代码：

<?php
// 获取用户输入的关键字
$keyword = isset($_GET['query']) ? $_GET['query'] : '';

// 防止 SQL 注入
$keyword = $conn->real_escape_string($keyword);

// 定义查询 SQL 语句
$sql = "SELECT * FROM products WHERE name LIKE '%$keyword%' LIMIT 5";

// 执行查询
$result = $conn->query($sql);

// 判断查询是否成功
if ($result->num_rows > 0) {
    $suggestions = [];
    while ($row = $result->fetch_assoc()) {
        $suggestions[] = $row['name'];
    }
    echo json_encode($suggestions); // 返回搜索建议列表
} else {
    echo json_encode([]); // 如果没有匹配的结果，返回空数组
}

$conn->close();
?>

在上面的代码中，首先通过 $_GET['query'] 获取用户输入的查询字符串，然后使用 real_escape_string() 方法来避免 SQL 注入攻击。接着，我们用 SQL 语句查询数据库中 products 表中 name 字段与用户输入的关键字相匹配的记录，最多返回 5 条建议。

mysqli_result 对象通过 fetch_assoc() 方法取出每一行的结果，并存入一个数组 $suggestions 中。最后，将这个数组转成 JSON 格式并输出，前端可以通过 AJAX 接收并显示搜索建议。

3. 前端代码

为了让这个后端接口与前端页面配合工作，我们需要在前端使用 JavaScript 通过 AJAX 向后端发送请求并接收返回的数据。以下是一个简单的前端代码示例：

<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>搜索建议示例</title>
    <style>
        #suggestions {
            border: 1px solid #ccc;
            max-height: 200px;
            overflow-y: auto;
        }
        .suggestion-item {
            padding: 8px;
            cursor: pointer;
        }
        .suggestion-item:hover {
            background-color: #f0f0f0;
        }
    </style>
</head>
<body>
    <input type="text" id="search" placeholder="输入搜索关键词..." oninput="getSuggestions()">
    <div id="suggestions"></div>

    <script>
        function getSuggestions() {
            var query = document.getElementById('search').value;
            if (query.length > 0) {
                var xhr = new XMLHttpRequest();
                xhr.open('GET', 'search_suggestions.php?query=' + query, true);
                xhr.onload = function() {
                    if (xhr.status == 200) {
                        var suggestions = JSON.parse(xhr.responseText);
                        displaySuggestions(suggestions);
                    }
                }
                xhr.send();
            } else {
                document.getElementById('suggestions').innerHTML = '';
            }
        }

        function displaySuggestions(suggestions) {
            var suggestionsDiv = document.getElementById('suggestions');
            suggestionsDiv.innerHTML = '';
            suggestions.forEach(function(item) {
                var div = document.createElement('div');
                div.classList.add('suggestion-item');
                div.textContent = item;
                suggestionsDiv.appendChild(div);
            });
        }
    </script>
</body>
</html>

在这段前端代码中，我们在输入框中使用了 oninput 事件，当用户输入字符时，会调用 getSuggestions() 函数，通过 AJAX 向 search_suggestions.php 发送请求并获取搜索建议。返回的建议会通过 displaySuggestions() 函数展示在页面上。

4. 总结

通过 PHP 和 MySQL，结合 mysqli_result 函数，我们成功实现了一个简单的后端搜索建议接口功能。用户输入关键词时，后端会根据数据库中的数据返回相关建议，而前端则通过 AJAX 动态显示这些建议。这个例子展示了如何利用 mysqli_result 来高效地从数据库中获取数据并将其返回给前端。