在CodeIgniter框架开发搜索功能时，实现搜索关键词高亮显示是提升用户体验的常见需求，系统自带的Highlight辅助函数可以快速完成这个功能的开发，不需要开发者手动编写复杂的正则替换逻辑。
Highlight辅助函数基础说明
Highlight辅助函数是CodeIgniter框架内置的辅助工具，主要作用是在指定文本中标记出匹配的关键词，默认会给关键词添加<strong>标签包裹，同时支持自定义包裹标签和样式属性。使用前需要先加载这个辅助函数，加载方式有两种，一种是在控制器中手动加载，另一种是在自动加载配置中全局加载。
手动加载方式
在需要使用高亮功能的控制器方法中，通过以下代码加载Highlight辅助函数：
<?php
// 加载Highlight辅助函数
$this->load->helper('highlight');
?>
全局自动加载方式
如果多个控制器都需要使用高亮功能，可以修改application/config/autoload.php文件，在$autoload['helper']数组中添加highlight元素，实现全局自动加载：
<?php
$autoload['helper'] = array('url', 'form', 'highlight');
?>
核心高亮方法使用
Highlight辅助函数提供了highlight_phrase()方法来实现关键词高亮，该方法的基本语法如下：
<?php highlight_phrase(string $str, string $phrase[, string $tag_open = '<strong>'[, string $tag_close = '</strong>']]) ?>
参数说明：
- $str：需要处理的原始文本内容
- $phrase：要匹配高亮的搜索关键词
- $tag_open：可选参数，自定义高亮开始的标签，默认是<strong>
- $tag_close：可选参数，自定义高亮结束的标签，默认是</strong>
基础使用示例
以下是简单的使用案例，在一段文本中高亮显示关键词CodeIgniter：
<?php // 原始文本 $content = 'CodeIgniter是一个轻量级的PHP开发框架，很多开发者选择CodeIgniter来快速搭建项目。'; // 搜索关键词 $keyword = 'CodeIgniter'; // 调用高亮方法 $highlighted_content = highlight_phrase($content, $keyword); echo $highlighted_content; // 输出结果：<strong>CodeIgniter</strong>是一个轻量级的PHP开发框架，很多开发者选择<strong>CodeIgniter</strong>来快速搭建项目。 ?>
自定义高亮样式
默认的<strong>标签只是加粗效果，实际开发中通常需要自定义高亮样式，比如修改文字颜色、背景色等。可以通过自定义$tag_open和$tag_close参数实现：
<?php $content = 'CodeIgniter框架的搜索功能开发很便捷。'; $keyword = '搜索功能'; // 自定义高亮标签，添加背景色和文字颜色样式 $tag_open = '<span style="background-color:#ffff00;color:#ff0000;">'; $tag_close = '</span>'; $result = highlight_phrase($content, $keyword, $tag_open, $tag_close); echo $result; // 输出结果：CodeIgniter框架的<span style="background-color:#ffff00;color:#ff0000;">搜索功能</span>开发很便捷。 ?>
实际搜索场景应用
在搜索功能中，通常是从数据库查询出匹配的内容，再对内容中的关键词进行高亮处理，以下是完整的控制器示例：
<?php
class Search extends CI_Controller {
public function index() {
// 加载Highlight辅助函数
$this->load->helper('highlight');
// 获取搜索关键词
$keyword = $this->input->get('keyword', TRUE);
// 模拟从数据库查询到的搜索结果列表
$search_results = array(
array('title' => 'CodeIgniter框架入门教程', 'content' => '本文介绍CodeIgniter框架的基础使用方法。'),
array('title' => 'CodeIgniter搜索功能开发', 'content' => '讲解如何在CodeIgniter中实现搜索功能。')
);
// 遍历结果，对标题和内容进行高亮处理
foreach ($search_results as &$item) {
$item['title'] = highlight_phrase($item['title'], $keyword, '<span class="highlight">', '</span>');
$item['content'] = highlight_phrase($item['content'], $keyword, '<span class="highlight">', '</span>');
}
// 传递数据到视图
$data['results'] = $search_results;
$data['keyword'] = $keyword;
$this->load->view('search_result', $data);
}
}
?>
对应的视图文件search_result.php中可以添加自定义的高亮样式：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>搜索结果</title>
<style>
.highlight {
background-color: #ffeb3b;
color: #d32f2f;
padding: 2px 4px;
border-radius: 2px;
}
</style>
</head>
<body>
<h2>搜索关键词：<?php echo $keyword; ?></h2>
<ul>
<?php foreach ($results as $item): ?>
<li>
<h3><?php echo $item['title']; ?></h3>
<p><?php echo $item['content']; ?></p>
</li>
<?php endforeach; ?>
</ul>
</body>
</html>
注意事项
- 如果关键词包含HTML特殊字符，
highlight_phrase()方法会自动处理转义，不需要开发者手动转义，避免XSS攻击风险。 - 该方法区分大小写，如果需要不区分大小写的高亮，可以先对原始文本和关键词统一转为小写再处理，或者自定义替换逻辑。
- 如果关键词是空字符串，方法会直接返回原始文本，不会进行任何处理。
CodeIgniterHighlight辅助函数搜索关键词高亮php修改时间：2026-07-08 22:54:40