在 web 开发中，经常会遇到需要动态修改 html 内容的情况。例如，根据用户权限，替换页面上某些包含特定类名的 div 元素。虽然使用 javascript 可以实现，但在服务器端使用 php 进行处理，可以更好地控制内容的生成和安全性。本文将详细介绍如何使用 php 的 domxpath 类来实现这一目标。
使用 DOMXPath 替换 div 代码块的步骤
以下是一个完整的示例，展示了如何使用 DOMXPath 替换 HTML 文档中包含特定类的整个 div 代码块。
-
加载 HTML 文档:
首先，需要将 HTML 文档加载到 DOMDocument 对象中。可以使用 loadHTML 方法从字符串加载，或者使用 loadHTMLFile 方法从文件中加载。
立即学习“PHP免费学习笔记（深入）”；
$html = '<div class="class"> cool content </div> <div class="class more-class life-is-hard locked-content"> <div class="cool-div"></div> <div class="anoter-cool-div"></div> some more code here </div> <div class="class"> cool content </div>'; $dom = new DOMDocument(); // Suppress errors due to malformed HTML libxml_use_internal_errors(true); $dom->loadHTML($html); libxml_clear_errors();注意: libxml_use_internal_errors(true) 和 libxml_clear_errors() 用于抑制由于 HTML 格式不规范可能产生的错误。在处理用户提交的 HTML 内容时，这尤其重要。
-
创建 DOMXPath 对象:
接下来，创建一个 DOMXPath 对象，用于查询 DOM 树。
$xpath = new DOMXPath($dom);
-
查询目标节点:
使用 DOMXPath 的 query 方法，通过 XPath 表达式查找包含特定类的 div 元素。 XPath 表达式 //div[contains(@class, "locked-content")] 表示查找所有 class 属性包含 "locked-content" 的 div 元素。
$nodes = $xpath->query('//div[contains(@class, "locked-content")]'); -
替换节点:
遍历找到的节点，并使用 replaceWith 方法替换它们。在替换之前，需要创建一个新的 DOM 节点来替换旧节点。
foreach ($nodes as $node) { // Create the replacement node $replacement = $dom->createElement('div', 'This content is now unlocked!'); $replacement->setAttribute('class', 'unlocked-content'); // Import the new node into the document $replacement = $dom->importNode($replacement, true); // Replace the old node with the new node $node->parentNode->replaceChild($replacement, $node); }注意: $dom->importNode($replacement, true) 是必要的，因为 $replacement 是使用当前的 $dom 对象创建的，需要将其导入到 $node 所属的文档中，才能进行替换。
-
输出结果:
最后，使用 saveHTML 方法将修改后的 DOM 文档保存为 HTML 字符串。
$newHtml = $dom->saveHTML(); echo $newHtml;
输出结果如下：
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd"> <html><body><div class="class"> cool content </div> <div class="unlocked-content">This content is now unlocked!</div> <div class="class"> cool content </div></body></html>
注意：saveHTML 方法会包含 HTML 的声明部分。如果只需要 <body> 标签内的内容，可以使用以下方法：
$body = $dom->getElementsByTagName('body')->item(0); $newHtml = ''; foreach ($body->childNodes as $node) { $newHtml .= $dom->saveHTML($node); } echo $newHtml;
完整代码示例:
<?php
$html = '<div class="class"> cool content </div>
<div class="class more-class life-is-hard locked-content">
<div class="cool-div"></div>
<div class="anoter-cool-div"></div>
some more code here
</div>
<div class="class"> cool content </div>';
$dom = new DOMDocument();
libxml_use_internal_errors(true);
$dom->loadHTML($html);
libxml_clear_errors();
$xpath = new DOMXPath($dom);
$nodes = $xpath->query('//div[contains(@class, "locked-content")]');
foreach ($nodes as $node) {
// Create the replacement node
$replacement = $dom->createElement('div', 'This content is now unlocked!');
$replacement->setAttribute('class', 'unlocked-content');
// Import the new node into the document
$replacement = $dom->importNode($replacement, true);
// Replace the old node with the new node
$node->parentNode->replaceChild($replacement, $node);
}
$body = $dom->getElementsByTagName('body')->item(0);
$newHtml = '';
foreach ($body->childNodes as $node) {
$newHtml .= $dom->saveHTML($node);
}
echo $newHtml;
?>总结与注意事项
- DOMXPath 提供了一种强大的方式来查询和修改 HTML 文档。
- 使用 contains(@class, "locked-content") 可以查找包含特定类的元素。
- replaceChild 方法用于替换节点。
- importNode 方法用于将节点导入到文档中。
- 在处理用户提交的 HTML 内容时，务必进行安全过滤，防止 XSS 攻击。
- libxml_use_internal_errors(true) 和 libxml_clear_errors() 用于抑制 HTML 解析错误，但同时也可能隐藏一些潜在的问题。
通过本文的介绍，你应该能够使用 PHP 的 DOMXPath 类来替换 HTML 文档中包含特定 CSS 类的整个 div 代码块。 这种方法可以应用于各种场景，例如动态内容替换、权限控制和内容过滤。
