es 可通过 highlight 参数的 pre_tags 和 post_tags 指定自定义高亮标签，如 [''] 和 ['']，使返回结果直接包含目标 html，无需 php 层替换。
ES 返回的 highlight 字段默认用 em 包裹关键词，怎么换成 span 加自定义 class？
ES 默认高亮标签是 <em></em>，但项目里已有 .highlight-keyword 样式，硬改全局 CSS 不现实，也不利于主题切换。必须在查询时指定替换标签。
关键点：不是 PHP 层二次替换，而是让 ES 在返回前就生成你要的 HTML。
-
highlight参数里加pre_tags和post_tags，值为字符串数组（哪怕只有一个） - 必须写成
['<span class="highlight-keyword">']</span>和['']，不能漏掉引号和分号 - 如果用 Blade 渲染，
{!! $hit['_source']['title'] !!}依然要配合htmlspecialchars_decode()或直接信任源（见下一条） - 别在 PHP 里用
str_replace('<em>', '<span class="highlight-keyword">', ...)</span></em>—— ES 可能嵌套高亮、转义过尖括号，会失效
示例查询参数：
$params = [
'index' => 'products',
'body' => [
'query' => ['match' => ['name' => $keyword]],
'highlight' => [
'fields' => ['name' => new \stdClass()],
'pre_tags' => ['<span class="highlight-keyword">'],
'post_tags' => ['</span>'],
'require_field_match' => true,
]
]
];
Laravel 中 highlight 字段返回空或没高亮，常见原因有哪些？
不是代码写错，就是配置或数据没对齐。最常踩的坑集中在字段映射和查询条件上。
- 字段没开启
store: true：ES 默认不存储原始字段值，highlight只能基于 _source 做高亮；若你用了"store": false（比如为了节省空间），高亮会失败或为空 - 查询字段和高亮字段不一致：比如查
match: { 'title^3' }，但highlight.fields写成['content']，自然没结果 - 中文分词器没配对：
analyzer用ik_max_word，但search_analyzer漏配或配成standard，导致查询词和索引词分词结果不匹配，查不到也就高亮不了 -
require_field_match: false没开：默认只高亮被查询命中的字段；如果想对所有文本字段统一高亮（比如 description + content），得显式设为false
从 ES highlight 提取纯文本时，怎么安全去掉 HTML 标签又不破坏语义？
有些场景（比如摘要预览、SEO meta description）需要剔除高亮标签，只留原文。但直接 strip_tags() 会吃掉所有标签，包括用户输入的合法 <p></p>、<strong></strong>。
- 用
preg_replace('/]*)?>/i', '', $highlighted)精准移除高亮标签，保留其他 HTML - 更稳妥的做法是先 DOMDocument 解析，只删指定 class 的
span或em节点，再$dom->saveHTML() - 千万别用
htmlspecialchars_decode(strip_tags(...))—— 顺序反了，strip_tags会把<当普通字符处理，解码后变成乱码 - 如果字段本身不含用户富文本（比如标题字段），直接
strip_tags($hit['highlight']['title'][0] ?? $hit['_source']['title'])就够用
Blade 里输出 highlight 内容，为什么页面显示的是 HTML 源码而不是渲染效果？
这是 Laravel 默认安全策略在起作用：{{ }} 会自动转义，<span class="...">xxx</span> 就真变成一串字符。
- 必须用
{!! $hit['highlight']['title'][0] !!}，注意是双大括号加感叹号 - 但前提是确认这个字段来自 ES 查询结果，且你控制了索引内容——ES 返回的高亮 HTML 是可信的（它不会执行 JS，也不会注入
<script></script>） - 如果字段原始内容来自用户输入（比如商品描述），而你又把整个
_source丢给 highlight，那就要先清洗：用strip_tags()或 DOMDocument 过滤后再高亮，否则可能带恶意属性 - 别在 JS 里拼
v-html输出 ES 高亮结果——Laravel 的 CSRF token 和 XSS 过滤器管不到前端 Vue 实例，风险不可控
真正容易被忽略的点：高亮字段名不一定叫 title，它取决于你 highlight.fields 里写的键；查不到时先 dd($hit) 看结构，别猜。
