自動完成(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', '資料庫');
<?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 ? '[' + 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 查詢。
- 上一篇程序編程: PHP 顏色反轉/補色計算:十六進位 RGB 色碼轉換工具函數
- 下一篇程序編程: PHP + jQuery + Ajax 實現無刷新用戶登入/登出系統完整教學