本文介绍如何在 PHP 的 DOMDocument 中，递归遍历任意嵌套深度的文本节点，将指定字符串（如 "some"）安全包裹进自定义 HTML 元素（如 ），同时严格保留原有 DOM 结构与标签层级。
本文介绍如何在 php 的 domdocument 中，递归遍历任意嵌套深度的文本节点，将指定字符串（如 "some"）安全包裹进自定义 html 元素（如 ``），同时严格保留原有 dom 结构与标签层级。
在 PHP 处理 HTML/XML 文档时，直接修改深层嵌套的文本节点（text nodes）并插入新元素是一个常见但易出错的需求。DOM 标准 API 不支持对 textContent 进行“部分替换并生成新节点”的原子操作，因此需采用节点遍历 + 文本拆分 + 安全重建的策略，而非简单字符串替换（str_replace）——后者会破坏标签结构、丢失属性、混淆 CDATA 或引号内容，且无法处理多处匹配或跨节点边界场景。
以下是一个健壮、可复用的实现方案，核心思路是：递归访问每个文本节点 → 检查其 data 是否包含目标字符串 → 若匹配，则将其分割为若干片段 → 用 包裹匹配项，其余保持为原始文本节点 → 插入到原位置替代原节点。
/**
* 在 DOMElement 及其所有后代中，将所有出现的 $search 字符串包裹进 $wrapperTag 元素
* @param DOMElement $element 要处理的根元素
* @param string $search 要查找并高亮的子字符串
* @param string $wrapperTag 包裹用的标签名（如 'span'）
* @param array $wrapperAttrs 可选：包裹元素的属性数组，如 ['class' => 'highlight']
*/
function wrapTextInNodes(DOMElement $element, string $search, string $wrapperTag = 'span', array $wrapperAttrs = []): void {
$xpath = new DOMXPath($element->ownerDocument);
// 使用 XPath 定位所有文本节点（排除注释、CDATA 等）
$textNodes = $xpath->query('.//text()[normalize-space()]', $element);
foreach ($textNodes as $textNode) {
$content = $textNode->nodeValue;
$pos = 0;
// 循环查找所有匹配位置（支持重叠？不推荐；此处为非重叠匹配）
while (($offset = strpos($content, $search, $pos)) !== false) {
// 创建前缀文本节点（未匹配部分）
if ($offset > $pos) {
$prefix = $textNode->ownerDocument->createTextNode(substr($content, $pos, $offset - $pos));
$textNode->parentNode->insertBefore($prefix, $textNode);
}
// 创建包裹元素
$wrapper = $textNode->ownerDocument->createElement($wrapperTag);
foreach ($wrapperAttrs as $attr => $value) {
$wrapper->setAttribute($attr, $value);
}
$wrapper->appendChild($textNode->ownerDocument->createTextNode($search));
// 插入包裹节点
$textNode->parentNode->insertBefore($wrapper, $textNode);
$pos = $offset + strlen($search);
}
// 插入剩余后缀文本节点
if ($pos < strlen($content)) {
$suffix = $textNode->ownerDocument->createTextNode(substr($content, $pos));
$textNode->parentNode->insertBefore($suffix, $textNode);
}
// 移除原始文本节点（已完成拆分）
$textNode->parentNode->removeChild($textNode);
}
}
// 使用示例
$html = <<<HTML
<text>This is some text with <i>some words in italics and <b>bold</b></i>.</text>
HTML;
$doc = new DOMDocument();
$doc->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
$doc->encoding = 'UTF-8';
// 获取目标元素（注意：loadHTML 会自动添加 html/body，故需定位到实际 text 元素）
$xpath = new DOMXPath($doc);
$target = $xpath->query('//text')->item(0);
if ($target instanceof DOMElement) {
wrapTextInNodes($target, 'some', 'span', ['class' => 'highlight']);
echo $doc->saveHTML($target); // 输出：<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>
}✅ 关键优势说明：
- ✅ 结构安全：不依赖 saveHTML()/str_replace()，完全基于 DOM API 操作，杜绝标签污染与解析错误；
- ✅ 深度兼容：通过 XPath .//text() 精确捕获任意嵌套层级的文本节点（包括 、 内部）；
- ✅ 可扩展性强：支持传入属性数组、自定义标签名，便于集成 CSS 类、data 属性或事件绑定；
- ✅ 空格与空白处理：normalize-space() 确保只处理含有效内容的文本节点，避免干扰换行/缩进节点。
⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 若目标字符串本身是 HTML 特殊字符（如
- 此方法不支持正则匹配；如需更复杂逻辑（如忽略大小写、单词边界），建议先用 preg_match_all() 定位位置，再按索引拆分；
- 对于超大文档，频繁 insertBefore() 可能影响性能，可考虑批量构建 DocumentFragment 后一次性替换。
总结而言，该方案以标准 DOM 操作为核心，兼顾准确性、可维护性与兼容性，是处理“文本节点内局部高亮/标记”类需求的推荐实践。
