萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP + jQuery UI Autocomplete 實現搜尋自動完成:從資料庫到前端完整整合

功能架構

自動完成(Autocomplete)核心流程:用戶輸入 → 前端防抖發送請求 → 後端模糊查詢資料庫 → 返回 JSON → 前端渲染下拉建議 → 用戶選擇填入。

資料庫準備

CREATE TABLE `articles` (
  `id` INT(11) NOT NULL AUTO_INCREMENT,
  `title` VARCHAR(200) NOT NULL,
  `slug` VARCHAR(220) NOT NULL,
  `category` VARCHAR(50) DEFAULT '',
  `view_count` INT(10) DEFAULT 0,
  PRIMARY KEY (`id`),
  KEY `idx_title` (`title`),
  FULLTEXT KEY `ft_title` (`title`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

-- 測試資料
INSERT INTO `articles` (`title`, `slug`, `category`) VALUES
('使用 CSS 和 jQuery 製作波浪效果的下拉選單', 'css-jquery-wave-dropdown', '前端'),
('使用 jQuery 和 CSS 控制頁面列印區域', 'jquery-css-print-area', '前端'),
('PHP 陣列去重技巧', 'php-array-unique', '後端'),
('MySQL 索引優化實戰', 'mysql-index-optimization', '資料庫');

後端 API 實現

<?php
// search.php
require_once 'connect.php';
header('Content-Type: application/json; charset=utf-8');

$term = isset($_GET['term']) ? trim($_GET['term']) : '';
if (mb_strlen($term) < 2) {
    echo json_encode([]);
    exit;
}

// 防止 SQL 注入 + 全文搜尋優化
$stmt = $conn->prepare("
    SELECT id, title, category 
    FROM articles 
    WHERE MATCH(title) AGAINST(? IN BOOLEAN MODE)
       OR title LIKE ?
    LIMIT 10
");
$searchTerm = $term . '*'; // 全文搜尋前綴模式
$likeTerm = "%{$term}%";
$stmt->bind_param('ss', $searchTerm, $likeTerm);
$stmt->execute();
$result = $stmt->get_result();

$suggestions = [];
while ($row = $result->fetch_assoc()) {
    $suggestions[] = [
        'id' => $row['id'],
        'label' => $row['title'],           // 顯示在下拉選單
        'value' => $row['title'],           // 選中後填入輸入框
        'category' => $row['category'],     // 自定義欄位
        'url' => "/article/{$row['slug']}"  // 可選:直接跳轉連結
    ];
}

echo json_encode($suggestions, JSON_UNESCAPED_UNICODE);
?>

前端整合

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>搜尋自動完成示例</title>
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/jquery-ui@1.13.2/themes/base/jquery-ui.min.css">
    <style>
        .ui-autocomplete { max-height: 300px; overflow-y: auto; overflow-x: hidden; z-index: 1000; }
        .ui-autocomplete-category { font-weight: bold; padding: 0.4em 0.6em; background: #f0f0f0; border-bottom: 1px solid #ddd; }
        .ui-menu-item { padding: 0.4em 0.6em; }
        .ui-menu-item .article-category { color: #666; font-size: 0.85em; margin-left: 8px; }
    </style>
</head>
<body>
    <h2>文章搜尋</h2>
    <input type="text" id="search" name="search" placeholder="輸入關鍵字(至少2字)" style="width:400px; padding:8px; font-size:16px;">
    
    <script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/jquery-ui@1.13.2/dist/jquery-ui.min.js"></script>
    <script>
    $(function() {
        $("#search").autocomplete({
            source: "search.php",
            minLength: 2,
            delay: 300,              // 防抖延遲
            autoFocus: true,         // 自動聚焦第一項
            // 自定義渲染下拉項目
            response: function(event, ui) {
                // 可選:按分類分組
            },
            // 自定義項目顯示 HTML
            _renderItem: function(ul, item) {
                return $("
  • ") .append($("
    ").html( "" + escapeHtml(item.label) + "" + (item.category ? '' : '') )) .appendTo(ul); }, // 選中事件 select: function(event, ui) { // 選項 1:填入輸入框並提交表單 // $(this).val(ui.item.value).closest('form').submit(); // 選項 2:直接跳轉(若有 url) if (ui.item.url) { window.location.href = ui.item.url; return false; // 防止填入輸入框 } } }).autocomplete("instance")._renderMenu = function(ul, items) { // 按分類分組渲染 var that = this, currentCategory = ""; $.each(items, function(index, item) { if (item.category && item.category !== currentCategory) { ul.append("
  • " + item.category + "
  • "); currentCategory = item.category; } that._renderItemData(ul, item); }); }; }); function escapeHtml(text) { return $('
    ').text(text).html(); } </script> </body> </html>

    進階優化

    1. 快取層(Redis/APCu)

    // search.php 開頭加入
    $cacheKey = 'autocomplete_' . md5($term);
    if ($cached = apcu_fetch($cacheKey)) {
        echo $cached; exit;
    }
    // ... 查詢資料庫 ...
    apcu_store($cacheKey, json_encode($suggestions), 300); // 快取 5 分鐘

    2. 熱門關鍵字優先

    // 記錄搜尋熱度
    $redis->zincrby('search_hot', 1, $term);
    // 查詢時合併熱門權重
    // SELECT ..., (view_count + COALESCE(hot_score,0)) AS rank ... ORDER BY rank DESC

    3. 中文分詞優化

    // 安裝 scws 擴展或使用 composer 套件
    // composer require fukuball/jieba-php
    require 'vendor/autoload.php';
    use Fukuball\Jieba\Jieba;
    Jieba::init();
    $seg = Jieba::cut($term); // 分詞
    // 使用分詞結果擴展查詢

    4. 修復 Firefox 中文輸入 Bug

    // jquery.ui.autocomplete.js 約 133 行後添加
    .bind("input.autocomplete", function() {
        // 修復 FF 不支援中文輸入法 composition 事件 bug
        var self = this;
        clearTimeout(self.compositionTimer);
        self.compositionTimer = setTimeout(function() {
            self.search(self.element.val());
        }, 0);
    });

    常見問題排查

    問題原因解決
    下拉不顯示JSON 格式錯誤/編碼問題確認 header Content-Type、JSON_UNESCAPED_UNICODE
    中文輸入無反應IME 合成事件未觸發 search加上 input 事件綁定或升級 jQuery UI
    請求過於頻繁未設定 delay/minLength設定 delay:300, minLength:2
    結果過多卡頓未限制 LIMIT、DOM 過多LIMIT 10、虛擬滾動、分頁加載

    總結

    Autocomplete 關鍵在於:後端高效查詢(全文索引/快取) + 前端防抖與渲染優化 + 良好 UX(分類、鍵盤導航、直接跳轉)。生產環境建議引入 Redis 快取熱門查詢,並考慮 Elasticsearch/Meilisearch 等專業搜尋引擎替代 LIKE 查詢。

    copyright © 萬盛學電腦網 all rights reserved