本文详解使用 PHP DOM 扩展递归遍历任意深度的文本节点，安全地将指定字符串（如 "some"）替换为带 标签的富文本结构，避免破坏原有 HTML 层级与实体编码。
本文详解使用 php dom 扩展递归遍历任意深度的文本节点，安全地将指定字符串（如 "some"）替换为带 `` 标签的富文本结构，避免破坏原有 html 层级与实体编码。
在 PHP 中处理 DOM 时，直接操作文本节点（DOMText）进行子字符串替换并插入新元素（如 ），需兼顾 DOM 结构完整性、HTML 实体安全性及嵌套层级正确性。简单使用 str_replace() 或正则替换原始 HTML 字符串虽看似快捷，但极易破坏标签结构、误匹配闭合标签或忽略字符实体（如 &），因此不推荐在真实项目中采用“字符串层面的 hack”方式（如答案中先 saveHTML() 再 str_replace() 后 appendXML() 的方案）。
✅ 正确做法是：递归遍历所有后代节点，定位纯文本节点（DOMText），对其 nodeValue 进行安全分段，并用 DOMDocument::createTextNode() 和 DOMDocument::createElement() 动态构建新节点序列，再通过 DOMNode::replaceChild() 原位替换。
以下是一个健壮、可复用的实现示例：
/**
* 在指定 DOMElement 的所有文本节点中，将目标字符串包裹为指定标签
* @param DOMElement $element 要处理的根元素
* @param string $search 要查找的字符串（支持普通字符串，暂不支持正则）
* @param string $tagName 包裹用的标签名，如 'span'
* @param array $attributes 可选：关联数组，如 ['class' => 'highlight', 'data-match' => '1']
*/
function wrapTextInNodes(DOMElement $element, string $search, string $tagName = 'span', array $attributes = []): void {
$doc = $element->ownerDocument;
// 递归处理所有子节点（包括深层嵌套）
$nodesToProcess = new RecursiveIteratorIterator(
new RecursiveNodeIterator($element),
RecursiveIteratorIterator::SELF_FIRST
);
foreach ($nodesToProcess as $node) {
// 仅处理文本节点，且内容非空
if ($node instanceof DOMText && trim($node->nodeValue) !== '') {
$content = $node->nodeValue;
$pos = 0;
$frag = $doc->createDocumentFragment();
// 循环查找所有匹配项（支持多次出现）
while (($offset = strpos($content, $search, $pos)) !== false) {
// 添加前置纯文本
if ($offset > $pos) {
$frag->appendChild($doc->createTextNode(substr($content, $pos, $offset - $pos)));
}
// 创建并配置包裹元素
$wrapper = $doc->createElement($tagName, $search);
foreach ($attributes as $attrName => $attrValue) {
$wrapper->setAttribute($attrName, $attrValue);
}
$frag->appendChild($wrapper);
$pos = $offset + strlen($search);
}
// 添加末尾剩余文本
if ($pos < strlen($content)) {
$frag->appendChild($doc->createTextNode(substr($content, $pos)));
}
// 替换原文本节点
if ($frag->hasChildNodes()) {
$node->parentNode->replaceChild($frag, $node);
}
}
}
}
// 使用示例
$html = <<<HTML
<text>This is some text with <i>some words in italics and <b>bold</b></i>.</text>
HTML;
$dom = new DOMDocument();
$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
$xpath = new DOMXPath($dom);
$textNode = $xpath->query('//text')->item(0);
if ($textNode) {
wrapTextInNodes($textNode, 'some', 'span', ['class' => 'highlight']);
echo $dom->saveHTML($textNode);
// 输出：<text>This is <span class="highlight">some</span> text with <i><span class="highlight">some</span> words in italics and <b>bold</b></i>.</text>
}? 关键注意事项：
立即学习“PHP免费学习笔记（深入）”；
- ✅ 安全优先：该方法完全基于 DOM API，不依赖字符串解析，天然规避 XSS 风险与标签错位；
- ⚠️ 不支持正则/模糊匹配：若需高级匹配逻辑（如大小写不敏感、单词边界），应在 strpos() 替换为 mb_stripos() 或封装 PCRE 逻辑，但务必确保只作用于纯文本内容；
- ? 编码兼容：DOMDocument 默认以 UTF-8 处理，确保源 HTML 声明正确（如 ）；
- ? 性能提示：对超大文档，可考虑限制递归深度或添加 continue 条件提前终止；
- ? 扩展建议：可进一步封装为 DOMElement 方法（通过继承或 Trait），或支持回调函数自定义包裹逻辑（如返回 DOMNode 而非固定 ）。
此方案真正实现了「语义化 DOM 操作」——尊重 HTML 结构、保留原有属性与嵌套关系，并提供清晰可控的替换行为，是生产环境处理富文本高亮、关键词标注等场景的推荐实践。
