ThinkPHP需借助Elasticsearch的suggest API实现站内搜索联想，通过Guzzle发送请求，推荐使用completion类型并配置中文分词器，控制器调用服务类返回JSON格式联想结果。
ThinkPHP 本身不内置 Elasticsearch 支持，实现站内搜索联想（Suggest）需借助 Elasticsearch 的 suggest API，并通过 HTTP 客户端（如 Guzzle）与 ES 交互。核心是构造符合 ES 规范的 suggest 查询请求，解析返回结果并返回给前端。
一、环境准备与基础连接
确保已部署 Elasticsearch（建议 7.x 或 8.x），并确认索引中已有数据且字段已启用 completion 类型或使用 phrase/term suggest。
- 推荐在 ThinkPHP 的
config/elasticsearch.php中配置 ES 地址、端口、索引名等，例如：
`'host' => 'http://127.0.0.1:9200', 'index' => 'article'` - 使用
guzzlehttp/guzzle发起请求：执行composer require guzzlehttp/guzzle - 避免直接在控制器里写 HTTP 请求逻辑，建议封装为 Service 类（如
ElasticsearchSuggestService）
二、构建 Completion Suggest（推荐用于标题/标签联想）
若希望实现类似“输入‘php’自动提示‘php教程’‘php面试题’”，应预先在 ES 索引中定义 completion 字段（需 mapping 显式设置），并在文档中存入 suggest 数据。
- mapping 示例（创建索引时设置）：
`"title_suggest": { "type": "completion" }` - 插入文档时带上 suggest 输入：
`"title_suggest": { "input": ["ThinkPHP 搜索联想", "TP6 Elasticsearch 集成"] }` - suggest 请求体（JSON 格式）：
`{ "suggest": { "title-suggest": { "prefix": "think", "completion": { "field": "title_suggest" } } } }`
三、ThinkPHP 控制器调用示例
在控制器中接收关键词参数，调用服务类获取联想结果，返回 JSON：
立即学习“PHP免费学习笔记（深入）”；
// app/controller/Search.php
public function suggest()
{
$keyword = input('keyword/s', '');
if (!$keyword) {
return json(['options' => []]);
}
$service = new ElasticsearchSuggestService();
$result = $service->completionSuggest($keyword);
// 提取 suggestion 文本列表
$options = [];
if (!empty($result['suggest']['title-suggest'][0]['options'])) {
foreach ($result['suggest']['title-suggest'][0]['options'] as $item) {
$options[] = $item['text'];
}
}
return json(['options' => $options]);
}
四、注意事项与常见问题
- ES 7+ 默认禁用
_type，请求 URL 应为：
`POST /your_index/_search`（不是/your_index/_doc/_search） - 中文需确保分词器支持（如 ik_smart），否则 completion suggest 对中文效果差；可改用
phrasesuggest + 中文分词器配合 - 前端建议加防抖（debounce），避免高频请求；后端可对 keyword 做长度限制（如 1–20 字符）和非法字符过滤
- 生产环境务必添加超时、重试、错误日志，例如 Guzzle 设置：
`'timeout' => 3, 'connect_timeout' => 2`
