PHP DOMXPath 如何判断 XPath 返回节点还是标量：表达式类型与空结果

用 PHP 的 DOMXPath 读 XML 时，最容易误判的是“查询结果到底是什么”。选择节点路径时，evaluate() 通常得到 DOMNodeList；XPath 表达式里使用 count() 或 string()，返回的则是整数或字符串。先按返回类型分支，再处理空结果，业务代码才不会把“没有节点”误当成空字符串。

节点查询先看结果类型：节点集用 DOMNodeList 判断长度，标量结果直接按整数或字符串处理；不要对所有返回值统一调用 length。

先把三种 XPath 结果分开

下面的 XML 只有一个订单节点，方便观察结果边界：

39.90

PHP 代码分别执行节点查询、计数查询和字符串查询。这里保留了真实的 evaluate()、DOMNodeList、count() 和 string() 标识符，因为它们正是分支判断的依据。

loadXML($xml);
$xpath = new DOMXPath($document);

$orders = $xpath->evaluate('/orders/order');
$orderCount = $xpath->evaluate('count(/orders/order)');
$status = $xpath->evaluate('string(/orders/order/@status)');

var_dump($orders instanceof DOMNodeList); // true
var_dump($orderCount);                    // 1
var_dump($status);                        // "paid"
?>

这三个值不能用同一种方式读取：$orders 要看 length，$orderCount 可直接参与数值比较，$status 则已经是字符串。

节点集先判断长度，再读取 item(0)

常见的线上问题不是 XPath 写错，而是路径在某些 XML 中没有命中。此时 $orders 仍然是 DOMNodeList，只是 length 为 0；直接读取 item(0) 得到的可能是 null，继续访问属性就会把问题推迟到更深的代码。

$orders = $xpath->evaluate('/orders/order[@status="refunded"]');

if (!$orders instanceof DOMNodeList || $orders->length === 0) {
    throw new RuntimeException('订单节点未找到');
}

$order = $orders->item(0);
$id = $order->attributes->getNamedItem('id')->nodeValue;

这段判断有两个价值：先确认返回类型，再确认集合非空。若 XPath 表达式后来被改成 string()，类型检查会立即暴露接口契约变化，而不是在 length 处产生含义模糊的错误。

把标量结果转换成明确的业务字段

count() 和 string() 更适合做存在性与字段提取，但仍要处理 XPath 没有命中的情况。string() 在空节点集上会给出空字符串，无法单独区分“节点不存在”和“节点存在但文本为空”。需要区分时，先用 count()，再读取字符串：

$amountCount = $xpath->evaluate('count(/orders/order/amount)');
if ($amountCount !== 1) {
    throw new RuntimeException('金额节点数量异常');
}

$amountText = $xpath->evaluate('string(/orders/order/amount)');
$amount = filter_var($amountText, FILTER_VALIDATE_FLOAT);
if ($amount === false) {
    throw new RuntimeException('金额不是有效数字');
}

这里的顺序是“数量校验—字符串提取—数值校验”。如果业务允许多个金额节点，就不要把 !== 1 写死，而应明确是取第一个、累加，还是直接拒绝输入。

三个容易踩中的边界

• 不要假设所有结果都有 length：count() 和 string() 返回标量。
• 不要把空字符串当成节点缺失的唯一证据：先用 count() 判断节点是否存在。
• 不要忽略 XML 命名空间：带命名空间的文档要先调用 registerNamespace()，否则合法路径也可能得到空的 DOMNodeList。

用一个小测试锁定返回类型

把 XPath 表达式当作接口的一部分测试，能避免后续改查询时悄悄改变返回类型：

self::assertInstanceOf(DOMNodeList::class, $orders);
self::assertSame(1, $orderCount);
self::assertSame('paid', $status);

最终检查集中在三件事：节点查询是否先判断 length，标量查询是否按实际类型比较，空结果是否有明确的异常或默认值。这样 DOMXPath 的查询变化就会在测试阶段暴露，而不会混进订单解析流程。

相关问题

DOMXPath 查询不到带命名空间的节点怎么办？

先用 registerNamespace() 给文档 URI 注册前缀，再在 XPath 中使用该前缀；不要直接把 XML 中的默认命名空间当成无前缀路径。

什么时候应该用 query() 而不是 evaluate()？

只需要节点集合时，query() 的意图更直接；需要 count()、string() 等标量结果时，再用 evaluate()。

记住“先确认 XPath 结果类型，再处理空值”的顺序，节点读取和业务字段转换就能各自保持清晰边界。