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 判断（简洁可靠）
这是最直接、兼容性最好的方式，适用于所有 PHP 版本：
$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 节点引用关系，不必要增加内存开销。
总结
| 方案 | 适用场景 | 推荐度 |
|---|---|---|
| foreach + nodeName | 快速验证、逻辑简单、需混合处理多种节点类型 | ⭐⭐⭐☆ |
| XPath 精准路径查询 | 主流需求（按标签名筛选）、强调性能与健壮性 | ⭐⭐⭐⭐⭐ |
始终优先让 XPath 承担选择职责，PHP 层专注业务逻辑处理——这才是 DOM/XPath 协同的最佳实践。