概述与问题分析
在使用php的domdocument和domxpath处理html内容，尤其是需要在文本节点中查找特定短语并用标签包裹它们时，开发者常会遇到一个棘手的问题。当对一个文本节点进行首次修改（例如使用splittext()方法）后，该节点的结构会发生变化。如果后续的修改仍然基于原始的偏移量，则会导致错误，常见的如fatal error: uncaught error: call to a member function splittext() on bool，因为splittext()可能返回false，表示无法在指定位置分割文本。
问题的核心在于DOMText::splitText(int $offset)方法。它将一个文本节点分割成两个，$offset之前的文本保留在原节点中，$offset及之后的文本则创建为一个新的DOMText节点并返回。一旦这个操作完成，原始文本节点的长度和内容都已改变，任何基于其原始状态计算出的后续偏移量都将失效。
解决方案：倒序处理与正确迭代
解决此问题的关键在于两点：
- 正确解析preg_match_all的结果： preg_match_all配合PREG_OFFSET_CAPTURE标志会返回一个多维数组。其中，$matches[0]包含所有完整的匹配项及其在原始字符串中的偏移量。直接迭代$matches数组可能导致重复处理或错误的数据访问。
- 倒序处理匹配项： 这是解决偏移量失效问题的核心策略。如果从文本节点的末尾向开头处理匹配项，每次修改只会影响当前匹配项之前（在原始文本中）的部分，而不会影响尚未处理的、位于当前匹配项之后（在原始文本中）的匹配项的偏移量。这样，所有后续（即更靠前）匹配项的偏移量在每次迭代时依然是有效的。
示例代码与实现细节
以下是结合了上述解决方案的PHP函数示例：
标签中，用于品牌目的。
*
* @param string $content 待处理的HTML内容。
* @return string 处理后的HTML内容。
*/
function ccjm_branding_filter(string $content): string {
// 仅在非管理后台且非AJAX请求时处理，且内容不为空
if (! (is_admin() && ! wp_doing_ajax()) && $content) {
$DOM = new DOMDocument();
// 使用内部错误处理来避免HTML5警告
libxml_use_internal_errors(true);
// 加载内容，确保正确编码并添加HTML包装以供解析
// LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD 用于避免添加不必要的标签
$DOM->loadHTML("{$content}", LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
// 清除加载HTML时可能产生的错误
libxml_clear_errors();
// 初始化XPath
$XPath = new DOMXPath($DOM);
// 检索所有文本节点，排除
