在 PHP 开发中实现搜索高亮，核心目标是把用户输入的关键词与结果文本进行匹配，再将命中的文字包裹一层可视化样式，例如改变颜色、增加背景色或加粗显示。这个功能看似只是简单的字符串替换，但实际涉及编码一致性、特殊字符转义、匹配边界以及 HTML 结构安全等多个细节。如果处理不当，可能出现中文乱码、样式标签嵌套错误、原始 HTML 被破坏等问题。
一、搜索高亮的核心思路与处理流程
实现搜索高亮的第一步，是明确输入与输出。输入通常包括待显示的原始文本、用户提交的搜索关键词，以及期望使用的高亮样式。输出则是经过处理后的 HTML 文本，其中命中的关键词会被包裹在带有样式的行内元素中。为了让后续替换稳定可靠，原始文本与关键词最好统一为 UTF-8 编码，尤其是在中文、日文等多字节字符场景下，编码不一致很容易导致匹配失败或显示异常。
第二步是查找关键词在文本中的位置。PHP 提供了多种字符串处理方式，例如 strpos、str_replace、preg_match、preg_replace 等。如果只需要简单精确替换，普通字符串函数也能完成任务；但如果希望忽略大小写、支持多字节字符、一次处理多个关键词，正则表达式会更灵活。使用正则时，需要先用 preg_quote 转义关键词中的特殊字符，避免用户输入的点号、斜杠、问号等字符被解释为正则语法。
第三步是替换与封装。匹配到关键词后，可以将其替换为带有内联样式的 <span> 元素，也可以替换为带有 class 的元素，再由 CSS 控制样式。无论采用哪种方式，都要保证插入的标签不会破坏原有 HTML 结构。如果原始内容本身包含 HTML 标签，应当先明确业务策略：是只高亮纯文本，还是允许在富文本中替换。对于搜索结果摘要这类场景，通常先去除或转义 HTML，再进行高亮，会更安全。
- 获取用户输入的搜索关键词和待处理的原始文本。
- 统一字符编码，优先使用 UTF-8，避免多字节字符处理异常。
- 使用字符串匹配或正则匹配定位关键词。
- 将命中的关键词替换为带有高亮样式的 HTML 片段。
- 返回处理后的文本，供前端页面展示。
二、单关键词高亮的 PHP 实现
下面这个示例展示了一个基础的搜索高亮函数。函数接收原始文本、关键词和样式参数，默认使用红色文字。为了避免正则表达式被用户输入干扰，示例中使用 preg_quote 对关键词进行转义，并在正则修饰符中加入 i 和 u，以便忽略大小写并按 UTF-8 模式处理多字节字符。
这个实现的关键在于，不直接拼接用户输入到正则中，而是先转义再匹配。这样即使关键词中包含正则特殊字符，也能按字面意义查找。同时，替换内容使用 <span> 包裹关键词本身，而不是替换成其他文字，因此可以保留原始语义，只改变视觉呈现。
<?php
/**
* 单关键词搜索高亮函数
* @param string $text 原始文本
* @param string $keyword 搜索关键词
* @param string $highlightStyle 高亮样式
* @return string 处理后的高亮文本
*/
function highlightSearchKeyword($text, $keyword, $highlightStyle = 'color:red;') {
// 关键词为空时直接返回，避免无效替换
if ($keyword === '') {
return $text;
}
// 转义正则特殊字符，避免用户输入影响正则解析
$escapedKeyword = preg_quote($keyword, '/');
// i 表示不区分大小写，u 表示按 UTF-8 处理多字节字符
$pattern = '/' . $escapedKeyword . '/iu';
// 将命中的关键词包裹在带有样式的行内元素中
$replacement = '<span style="' . $highlightStyle . '">' . $keyword . '</span>';
return preg_replace($pattern, $replacement, $text);
}
// 测试数据
$originalText = '这是一段测试文本，搜索功能可以帮助用户快速找到需要的内容，搜索体验很重要';
$searchKeyword = '搜索';
// 输出高亮后的文本
echo highlightSearchKeyword($originalText, $searchKeyword);
?>
运行上述代码后，文本中出现的关键词会被包裹在 <span> 中，浏览器渲染时即可看到高亮效果。如果希望在页面中更明显，可以把样式参数改成背景色、边框或加粗。需要注意的是，若输出环境不是 HTML，而是纯文本接口或命令行，则不应插入 HTML 标签，可以改用终端颜色或返回匹配位置。
此外，若关键词为空，函数会直接返回原始文本。这个判断虽然简单，但非常重要。空关键词如果进入正则替换，可能产生无意义匹配或错误。对于只包含空白字符的关键词，也可以先使用 trim 处理，再判断是否为空，以避免高亮空格。
| 参数 | 作用 |
|---|---|
$text | 需要进行高亮处理的原始文本。 |
$keyword | 用户输入的搜索关键词。 |
$highlightStyle | 高亮样式，可以是颜色、背景色、加粗等 CSS 样式。 |
三、边界问题、多关键词扩展与样式控制
实际项目中，搜索高亮往往不会只处理一个关键词。用户可能输入多个词，系统也可能对分词后的结果逐个高亮。此时可以把关键词整理成数组，再逐个调用单关键词函数。下面的扩展示例在保留基础函数的同时，增加了多关键词处理能力，并允许统一传入高亮样式。
多关键词处理看似只是循环替换，但要注意替换顺序与嵌套风险。如果某个关键词恰好是另一个关键词的一部分，或者关键词能够匹配到已经插入的 HTML 属性，就可能造成标签嵌套混乱。较为稳妥的做法是在纯文本阶段完成高亮，最后再输出 HTML；也可以设计一次性正则匹配多个关键词，避免反复扫描已插入的标签。
<?php
/**
* 单关键词搜索高亮函数
*/
function highlightSearchKeyword($text, $keyword, $highlightStyle = 'color:red;') {
if ($keyword === '') {
return $text;
}
$escapedKeyword = preg_quote($keyword, '/');
$pattern = '/' . $escapedKeyword . '/iu';
$replacement = '<span style="' . $highlightStyle . '">' . $keyword . '</span>';
return preg_replace($pattern, $replacement, $text);
}
/**
* 多关键词搜索高亮函数
* @param string $text 原始文本
* @param array $keywords 搜索关键词数组
* @param string $highlightStyle 高亮样式
* @return string 处理后的高亮文本
*/
function highlightMultipleKeywords($text, array $keywords, $highlightStyle = 'color:red;') {
foreach ($keywords as $keyword) {
// 跳过空字符串，避免无意义替换
if ($keyword !== '') {
$text = highlightSearchKeyword($text, $keyword, $highlightStyle);
}
}
return $text;
}
// 测试多关键词高亮
$originalText = 'PHP 是一种流行的服务器端脚本语言，适合开发 Web 应用';
$searchKeywords = ['PHP', 'Web'];
$highlightStyle = 'background:#fffb78;color:#333;padding:0 2px;';
echo highlightMultipleKeywords($originalText, $searchKeywords, $highlightStyle);
?>
在样式控制方面，可以根据需求传入不同的 CSS。例如，使用 background:#fffb78; 可以突出显示命中片段，使用 color:#c00;font-weight:bold; 则可以同时改变颜色并加粗。如果项目使用外部样式表，也可以将替换内容写成带有 class 的元素，例如 <em class="search-highlight">，然后在 CSS 中统一维护视觉效果。这样更利于主题切换与样式复用。
如果原始文本中包含 HTML 标签，建议先剥离标签或进行转义，再执行高亮。否则替换可能发生在标签属性内部，导致 HTML 结构损坏。例如，关键词如果出现在 <img> 的 alt 属性或链接地址中，直接插入 <span> 就可能让页面解析异常。对于富文本内容，可以先提取纯文本摘要，再对摘要进行高亮；也可以设计更复杂的 DOM 处理流程，只在文本节点中替换。
- 关键词为空或只包含空白字符时，应避免进入替换逻辑。
- 关键词中的正则特殊字符应通过
preg_quote转义。 - 处理中文等多字节字符时，应使用 UTF-8 编码并启用正则的
u修饰符。 - 原始文本包含 HTML 时，应优先保证 HTML 结构安全。
- 多关键词高亮时，应关注重复替换和标签嵌套问题。
四、总结与延伸建议
整体来看，PHP 实现搜索高亮的主线非常清晰：统一编码、安全匹配、包裹样式、控制边界。对于中小型项目，使用 preg_quote 加 preg_replace 的方案已经能够覆盖大多数需求；对于内容复杂、富文本较多的系统，则需要额外考虑 HTML 安全与标签嵌套问题。
在进一步优化时，可以把高亮逻辑封装成独立工具函数，并配合单元测试覆盖中文、英文、特殊字符、空关键词、多关键词等场景。也可以将高亮样式参数化，让不同页面使用不同视觉方案。只要把匹配安全与 HTML 结构安全处理好，搜索高亮就能在保持内容可读性的同时，明显提升用户定位关键信息的效率。