本文讲解如何使用 PHP 的 preg_replace 函数，精准匹配并高亮文本中任意大小写的指定单词（如“filho”或“Filho”），为其自动包裹 标签，同时保持原始大小写不变。
本文讲解如何使用 php 的 `preg_replace` 函数，精准匹配并高亮文本中任意大小写的指定单词（如“filho”或“filho”），为其自动包裹 `` 标签，同时保持原始大小写不变。
在 Laravel 视图中直接对动态文本做关键词高亮时，不能仅依赖 Blade 的原始输出（如 {{ $v->palavra }}），而需在 PHP 层完成带边界保护、大小写不敏感、保留原格式的替换。核心方案是使用正则表达式函数 preg_replace()，配合单词边界（\b）和 i 修饰符。
✅ 正确实现步骤
-
在控制器中预处理数据：对每个
$versiculo的文本字段（假设为$v->texto，而非$v->palavra）执行高亮替换； -
使用
\b确保完整单词匹配（避免匹配到“afilho”或“filhos”中的子串）； -
启用
i修饰符实现大小写不敏感； -
用捕获组
()+$1回溯引用，完美保留原始大小写。
示例代码（修改你的控制器方法）：
public function palavras(Request $request, $palavra = null)
{
$getpalavra = palavras_br::where('slug', $palavra)->first();
if (!$getpalavra) {
abort(404);
}
$targetWord = preg_quote($getpalavra->palavras, '/'); // 转义特殊字符，如点、括号等
$versiculos = nvi::where('palavra', 'RLIKE', '[[:<:]]'.$getpalavra->palavras.'[[:>:]]')
->paginate(20);
// 对每条记录的文本字段（例如 'texto'）进行高亮处理
$versiculos->getCollection()->transform(function ($item) use ($targetWord) {
// 假设原文本存于 $item->texto 字段
$item->texto_destacado = preg_replace(
'/\b(' . $targetWord . ')\b/i',
'<strong>$1</strong>',
$item->texto ?? ''
);
return $item;
});
return view('palavra', compact('versiculos', 'getpalavra'));
}⚠️ 注意：请将
$item->texto替换为你实际存储经文内容的字段名（如conteudo、verso等）。若字段名是palavra，则逻辑需重新审视——因为palavra通常是关键词本身，而非上下文文本。
✅ 视图中安全输出高亮结果
在 Blade 模板中，使用 {!! !!} 输出已转义的 HTML（确保内容可信）：
立即学习“前端免费学习笔记（深入）”；
@foreach($versiculos as $v)
<p>{!! $v->texto_destacado !!}</p>
@endforeach? 安全提示：仅当
$v->texto来自受信数据源（如数据库固定字段）时才用{!! !!}。若含用户输入，须额外过滤 XSS（如strip_tags()或 HTMLPurifier）。
? 补充说明与最佳实践
为什么不用
str_ireplace？str_ireplace不支持单词边界，会错误匹配子串（如把 “filhos” →<strong>filho</strong>s），且无法精准控制词界。为什么用
preg_quote？
若$getpalavra->palavras包含正则元字符（如ca+o、joão中的ã通常无害，但.、*、?等会破坏模式），preg_quote()可防止正则解析异常。性能考虑：
对于大量数据，可考虑前端高亮（JS）或缓存处理结果；但小规模经文检索下，PHP 层处理简洁可靠。
通过以上方式，无论是 “filho”、“Filho” 还是 “FILHO”，都将被原样包裹为 <strong>filho</strong>、<strong>Filho</strong> 或 <strong>FILHO</strong>，语义准确、视觉清晰、代码健壮。
