本教程旨在指导开发者如何使用PHP的DOM扩展（DOMDocument和DOMXPath）从复杂的HTML字符串中准确提取所有指定级别的标题（例如

）及其紧邻的第一个段落。文章将详细解释为何不推荐使用正则表达式解析HTML，并提供一个结构清晰、易于理解的DOM解析方案及完整的示例代码，帮助读者高效处理HTML内容。

在Web开发中，我们经常需要从HTML内容中提取特定信息，例如所有三级标题（

）及其紧随的第一个段落（

）。虽然正则表达式（RegEx）在字符串匹配方面功能强大，但处理HTML这种具有复杂嵌套结构的标记语言时，它往往力不从心，容易出错且难以维护。

为什么不推荐使用正则表达式解析HTML

HTML不是一种正则语言，它具有递归和上下文相关的特性。这意味着使用正则表达式来解析HTML标签（特别是当涉及到嵌套、属性或不规范的HTML时）非常困难，几乎不可能写出一个既健壮又准确的正则表达式来处理所有可能的情况。常见的挑战包括：

• 嵌套结构： HTML标签可以任意嵌套，正则表达式很难正确匹配深层嵌套的标签。
• 属性变化： 标签属性的顺序、数量和值是可变的，增加了正则表达式的复杂性。
• 不规范HTML： 实际网页中常常存在不规范的HTML，正则表达式对此缺乏容错能力。
• 维护困难： 复杂的正则表达式难以阅读、理解和维护。

因此，业界普遍推荐使用专门的HTML解析器来处理HTML文档，这些解析器能够理解HTML的结构和语义。

使用PHP DOM解析器提取HTML内容

PHP提供了一个内置的DOM扩展，允许开发者以面向对象的方式操作HTML和XML文档。DOMDocument 类用于加载和表示整个文档，而 DOMXPath 类则允许我们使用XPath查询语言来查找文档中的特定元素。

1. 加载HTML字符串

首先，我们需要创建一个 DOMDocument 实例，并将HTML字符串加载到其中。为了避免解析HTML片段时可能出现的警告或错误（例如缺少html>、

This is my title

This is a text right under my h1 title.
This is some more text under my h1 title

This is my level 2 heading
This is text right under my level 2 heading

First h3
First paragraph for the first h3

Second h3
First paragraph for the second h3

Third h3
First paragraph for the third h3
Second paragraph for the third h3

This is my level 2 heading
This is text right under my level 2 heading
TAG;

$dom = new DomDocument();
// 加载HTML，使用选项避免对HTML片段自动添加缺失的标签
$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);

?>

• LIBXML_HTML_NOIMPLIED: 防止libxml自动添加隐含的, , 标签。
• LIBXML_HTML_NODEFDTD: 防止libxml自动添加默认的DTD。 这些选项对于处理HTML片段而非完整文档时非常有用，可以保持HTML结构与原始输入更一致。

2. 使用DOMXPath查询元素

DOMXPath 提供了强大的XPath查询能力，可以让我们精确地定位文档中的元素。我们需要创建一个 DOMXPath 实例，并使用它来查询所有

标签。

标签
// "//h3" 表示查找文档中所有h3元素，无论其在文档的哪个位置
$results = $xpath->query("//h3");

?>

3. 遍历结果并提取紧邻段落

$results 是一个 DOMNodeList 对象，我们可以像遍历数组一样遍历它。对于每一个

元素，我们需要找到其紧邻的下一个兄弟元素，并检查它是否是

标签。

DOMElement 对象提供了一个 nextElementSibling 属性，它返回元素的下一个兄弟元素节点（忽略文本节点和注释节点）。这是一个非常方便的属性，用于获取紧邻的下一个元素。

textContent); // 获取
的文本内容
    $paragraph_text = '';

    // 获取下一个兄弟元素
    $next_element = $h3_element->nextElementSibling;

    // 检查下一个元素是否存在且是
标签
    if ($next_element && 'p' === $next_element->nodeName) {
        $paragraph_text = trim($next_element->textContent); // 获取
的文本内容
    }

    $extracted_data[] = [
        'heading' => $h3_text,
        'paragraph' => $paragraph_text
    ];
}

// 打印提取到的数据
foreach ($extracted_data as $item) {
    echo "
" . htmlspecialchars($item['heading']) . "
\n";
    echo "
" . htmlspecialchars($item['paragraph']) . "
\n";
}

?>

完整示例代码：

This is my title

This is a text right under my h1 title.
This is some more text under my h1 title

This is my level 2 heading
This is text right under my level 2 heading

First h3
First paragraph for the first h3

Second h3
First paragraph for the second h3

Third h3
First paragraph for the third h3
Second paragraph for the third h3

This is my level 2 heading
This is text right under my level 2 heading
TAG;

// 1. 创建DOMDocument实例并加载HTML
$dom = new DomDocument();
// 使用LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD选项处理HTML片段
$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);

// 2. 创建DOMXPath实例
$xpath = new DOMXPath($dom);

// 3. 查询所有
标签
$h3_elements = $xpath->query("//h3");

$extracted_content = [];

// 4. 遍历所有
标签，并提取其紧邻的第一个
标签
foreach ($h3_elements as $h3_node) {
    $heading_text = trim($h3_node->textContent);
    $paragraph_text = '';

    // 获取当前
节点的下一个兄弟元素
    $next_sibling = $h3_node->nextElementSibling;

    // 检查下一个兄弟元素是否存在且其标签名为'p'
    if ($next_sibling instanceof DOMElement && $next_sibling->nodeName === 'p') {
        $paragraph_text = trim($next_sibling->textContent);
    }

    $extracted_content[] = [
        'heading' => $heading_text,
        'paragraph' => $paragraph_text
    ];
}

// 5. 输出提取到的内容
echo "
提取结果：
\n";
foreach ($extracted_content as $item) {
    echo "
" . htmlspecialchars($item['heading']) . "
\n";
    echo "
" . htmlspecialchars($item['paragraph']) . "
\n";
}

?>

预期输出：

提取结果：
First h3
First paragraph for the first h3
Second h3
First paragraph for the second h3
Third h3
First paragraph for the third h3

注意事项与最佳实践

• 错误处理： 在实际应用中，HTML内容可能不规范或缺失某些标签。在访问 nextElementSibling 或 textContent 之前，最好进行 null 或类型检查，以避免潜在的错误。
• HTML编码： 当将提取的文本重新输出到HTML页面时，务必使用 htmlspecialchars() 或 htmlentities() 对文本进行编码，以防止跨站脚本（XSS）攻击。
• 更复杂的选择器： DOMXPath 支持非常复杂的XPath表达式，例如 //h3/following-sibling::p[1] 可以直接选择每个

  后面的第一个

  兄弟元素，而不需要手动检查 nodeName。然而，nextElementSibling 在处理紧邻元素时更为直观和高效。

• 性能： 对于非常大的HTML文件，DOM解析可能会消耗较多的内存。如果内存成为瓶颈，可以考虑使用流式解析器，但这会增加代码的复杂性。对于大多数网页抓取和内容提取任务，DOM解析器是足够的。

总结

通过本教程，我们学习了如何使用PHP的DOM扩展来可靠地解析HTML并提取特定元素及其紧邻内容。相比于正则表达式，DOM解析器提供了一种更健壮、更语义化的方式来处理HTML文档，大大降低了出错的风险并提高了代码的可维护性。掌握DOMDocument和DOMXPath是进行高效HTML内容处理的关键技能。