如何从 DOMNodeList 中按标签名筛选节点

domnodelist 是只读的节点集合，不提供 getelementsbytagname 方法；需遍历后通过 nodename 属性手动过滤目标标签，或改用 xpath 二次查询实现更精准、高效的选择。

在 PHP 的 DOM 扩展中，DOMNodeList 是一个只读的节点集合对象，它本身不继承自 DOMElement 或 DOMNode，因此不具备 getElementsByTagName() 这类属于单个节点（如 DOMElement）的方法。你遇到的错误：

Uncaught Error: Call to undefined method DOMNodeList::getElementsByTagName()

正是因为 getElementsByTagName() 是 DOMDocument 和 DOMElement 的方法，而 DOMNodeList（如 $related_notions）只是一个迭代器式容器，无法直接调用该方法。

✅ 正确做法一：遍历 + nodeName 判断（简洁可靠）

这是最直接

$index = new DOMDocument();
$index->load('index.xml');
$xpath = new DOMXPath($index);

// 获取 /index/notion[name='xxx']/relations/ 下的所有子元素
$related_notions = $xpath->query("/index/notion[name='" . htmlspecialchars($name, ENT_XML1) . "']/relations/*");

foreach ($related_notions as $item) {
    if ($item instanceof DOMElement && $item->nodeName === 'superordinate') {
        // ✅ 安全执行操作（例如获取文本、属性等）
        echo $item->textContent . "\n";
    }
}

⚠️ 注意事项：始终建议使用 htmlspecialchars($name, ENT_XML1) 防止 XPath 注入（尤其当 $name 来自用户输入时）；显式检查 instanceof DOMElement 可避免处理文本节点、注释等非元素节点引发的意外行为；使用 === 严格比较 nodeName，避免因大小写或空格导致误判（XML 标签名区分大小写）。

✅ 正确做法二：用 XPath 一次性精准定位（推荐，更高效）

与其在 PHP 层过滤，不如让 XPath 直接返回所需节点——语义清晰、性能更优、代码更简洁：

// 直接查询 superordinate 元素（无需 PHP 层过滤）
$superordinates = $xpath->query("/index/notion[name='" . htmlspecialchars($name, ENT_XML1) . "']/relations/superordinate");

foreach ($superordinates as $item) {
    // $item 已确保是  元素
    echo $item->getAttribute('id') . ': ' . $item->textContent . "\n";
}

✅ 优势：

• 避免无谓遍历无关节点（如 subordinate、synonym 等）；
• 利用底层 libxml 优化，比 PHP 循环更快；
• 逻辑集中、可读性强，便于后续扩展（例如添加 [@active='true'] 属性条件）。

❌ 不推荐的做法

• 尝试将 DOMNodeList 强转为 DOMDocument 或 DOMElement 后调用 getElementsByTagName() —— 语法非法且无意义；
• 使用 iterator_to_array() 后再 array_filter() —— 冗余且丧失 DOM 节点引用关系，不必要增加内存开销。

总结

始终优先让 XPath 承担选择职责，PHP 层专注业务逻辑处理——这才是 DOM/XPath 协同的最佳实践。