PHP搜索关键词高亮需先剥离/保护HTML再精准匹配文本节点，推荐DOM方式遍历text()节点用mb_stripos定位并替换，兼顾多词排序、边界控制、次数限制及前端样式适配。
PHP 实现搜索关键词高亮，核心在于安全地匹配关键词、避免重复嵌套、兼顾大小写与HTML结构。直接用 str_replace 或正则粗暴替换极易破坏原有 HTML 标签、引发 XSS 风险或高亮错位（比如在 <div class="keyword"> 里误高亮 keyword）。真正可用的方案需先剥离/保护 HTML，再精准定位文本节点进行包裹。
一、基础安全高亮：剥离HTML后处理纯文本
适用于内容以用户输入为主、HTML 结构简单（如文章摘要、评论正文）的场景。关键点是：先 htmlspecialchars 解码 → 剥离标签 → 高亮纯文本 → 再还原标签。
- 用
html_entity_decode($content, ENT_QUOTES, 'UTF-8')统一解码实体 - 用
strip_tags($content)获取纯文本，但注意它会丢失换行等格式；更稳妥用preg_replace('/]*>/', ' ', $content)粗略清理标签并保留空格分隔 - 对纯文本执行高亮：用
preg_quote($keyword, '/')转义关键词正则特殊字符，再用preg_replace("/({$quoted})/i", '<span class="highlight">$1</span>', $text) - 最终把高亮后的文本重新插入原始 HTML 的文本位置 —— 这步需 DOM 解析，见下一部分
二、DOM 方式精准高亮：不破坏原有结构
推荐生产环境使用。借助 PHP 内置 DOMDocument 遍历所有文本节点，只在纯文本内容中匹配关键词，完全避开标签干扰。
- 创建
$dom = new DOMDocument();，用$dom->loadHTML(mb_convert_encoding($html, 'HTML-ENTITIES', 'UTF-8'), LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);加载 HTML（加mb_convert_encoding防止中文乱码） - 用
$xpath = new DOMXPath($dom);查找所有文本节点：$nodes = $xpath->query('//text()[normalize-space()]'); - 遍历每个
$node，获取其$node->nodeValue，用mb_stripos定位关键词起始位置（支持中文），再用mb_substr切分前后文 - 用
$node->parentNode->replaceChild(...)将原节点替换成：普通文本节点 +<span class="highlight">关键词</span>+ 普通文本节点 - 最后
$dom->saveHTML()输出结果，自动保持原有属性和结构
三、支持多关键词与模糊匹配的增强逻辑
用户常搜“php 教程”，需同时高亮 “php” 和 “教程”，且不希望 “phper” 被误匹配为 “php”。这时需控制匹配边界和优先级。
立即学习“PHP免费学习笔记（深入）”；
- 多关键词：将关键词数组按长度从长到短排序（如 ['php 教程', '教程', 'php']），防止短词在长词内部重复高亮
- 单词边界：正则中使用
\b{$quoted}\b（仅英文有效）；中文需改用(?（Unicode 中文范围负向断言） - 忽略 HTML 属性值：DOM 方式天然规避此问题；若用正则，务必跳过
href=... title=...等属性内容，否则链接地址被高亮会导致页面失效 - 限制高亮次数：每段文本最多高亮 3 处，避免长文满屏黄色，用计数器在循环中控制
四、前端配合与样式建议
高亮只是后端生成 <span class="highlight">，最终效果依赖 CSS 和浏览器渲染。别忽略这些细节：
- CSS 中定义
.highlight { background-color: #ffeb3b; color: #212121; }，避免用!important干扰主题样式 - 为防止高亮文字换行断裂，加
white-space: break-spaces;或word-break: keep-all; - 移动端需测试小屏幕下高亮是否挤压排版，可加
font-size: inherit;保证缩放一致性 - 如果搜索页启用 PJAX，记得 JS 侧也要复现高亮逻辑（后端只负责首次渲染），或统一由后端返回带高亮的 HTML 片段
不复杂但容易忽略：关键词本身含 HTML 字符（如搜索 <script></script>）必须提前 htmlspecialchars($keyword) 转义，否则高亮标签会被浏览器解析执行。安全永远比炫酷重要。
