PHP XMLReader 读取属性后怎样回到当前元素

在 PHP XMLReader 中，读取属性后想回到当前元素，直接调用 $reader->moveToElement() 即可。它只在游标当前位于属性节点时，把游标放回这个属性所属的父元素；如果当前游标已经在元素、文本或结束节点上，方法会返回 false。

官方地址：https://www.php.net/manual/en/book.xmlreader.php

最容易混淆的是 getAttribute() 和 moveToAttribute()：前者读取指定属性但不改变游标位置，后者会把游标移动到属性节点。只有真正移动到属性节点后，moveToElement() 才有“回到元素”的对象。

XMLReader 的元素游标和属性游标不是一回事

XMLReader 是向前读取 XML 文档流的游标。遍历到 时，当前节点类型是 XMLReader::ELEMENT；调用 moveToAttribute('id') 后，当前节点类型变成 XMLReader::ATTRIBUTE，此时 name 是 id，value 是 b01。

属性节点属于当前元素的局部视图，不是文档流中的下一个元素。属性之间可以用 moveToNextAttribute() 移动，读完后需要用 moveToElement() 回到父元素，再决定是读取元素信息、检查 isEmptyElement，还是调用 read() 进入后续文档节点。

用 moveToAttribute 读取后再用 moveToElement 回到元素

如果只需要读取一个属性，推荐先确认当前节点是元素，再移动到属性。属性读取成功后，立刻调用 moveToElement()，让后续代码回到稳定的元素上下文。

XMLReader');

while ($reader->read()) {
    // 只在元素节点上读取属性，避免在文本节点调用属性移动方法。
    if ($reader->nodeType !== XMLReader::ELEMENT || $reader->name !== 'book') {
        continue;
    }

    // moveToAttribute 会把当前游标移动到 id 属性节点。
    if ($reader->moveToAttribute('id')) {
        $id = $reader->value;

        // 回到 id 所属的 book 元素，后续再读取元素属性或状态。
        if ($reader->moveToElement()) {
            echo $reader->name . ':' . $id;
        }
    }
}

// 释放解析器资源，避免长任务一直持有输入流。
$reader->close();

这里的关键不是把属性值保存到变量，而是恢复游标。moveToElement() 返回 true 后，name、isEmptyElement 和后续属性操作又对应 book 元素。

多个属性循环时，不要把属性移动和 read 混在一起

处理多个属性时，可以先在元素节点上记录元素名，再用 moveToFirstAttribute() 和 moveToNextAttribute() 遍历属性。遍历结束后回到元素，再调用 read() 进入文档流的下一个节点。这样能把“当前元素有哪些属性”和“文档接下来读什么”分成两件事。

');

while ($reader->read()) {
    // 只处理 book 起始元素，避免把结束元素重复当成新记录。
    if ($reader->nodeType !== XMLReader::ELEMENT || $reader->name !== 'book') {
        continue;
    }

    $attributes = [];
    // 从第一个属性开始，逐个读取当前元素的属性节点。
    if ($reader->moveToFirstAttribute()) {
        do {
            // name/value 现在指向属性节点，而不是 book 元素。
            $attributes[$reader->name] = $reader->value;
        } while ($reader->moveToNextAttribute());

        // 属性遍历结束后，恢复到父元素再交还给下一轮 read。
        $reader->moveToElement();
    }

    echo json_encode($attributes, JSON_UNESCAPED_UNICODE) . PHP_EOL;
}

// 关闭流式读取器，明确结束本次解析。
$reader->close();

属性循环中的 moveToNextAttribute() 只在当前元素的属性集合中移动，不会走到下一个 。真正让 XMLReader 前进到后续节点的是外层的 read()。

三个容易踩到的边界

• 属性不存在：moveToAttribute() 返回 false，不要直接读取 value 并把失败当成空字符串。
• 当前不在属性节点：moveToElement() 只对属性游标有意义。如果你使用的是 getAttribute()，游标通常仍在元素上，不需要再“回去”。
• 空元素：遍历属性后，先 moveToElement() 再读取元素状态；属性游标下的状态属性不能当成父元素状态来理解。

可以用下面的速查表判断该调用哪个方法：

常见问题

调用 getAttribute 后还需要 moveToElement 吗？

通常不需要。getAttribute() 直接返回属性值，不把游标移到属性节点；只有使用 moveToAttribute() 或属性遍历方法后，才需要考虑恢复元素。

moveToElement 返回 false 怎么办？

先检查调用前的 nodeType。如果当前节点不是 XMLReader::ATTRIBUTE，返回 false 是正常的边界反馈，应调整游标流程，而不是重复调用。

回到元素后要立即调用 read 吗？

不一定。若还要读取当前元素的名称、空元素状态或其他属性，先在元素上下文完成；确认当前元素处理完毕后，再调用 read() 进入后续节点。

记住一句话：moveToAttribute() 负责进入属性节点，moveToElement() 负责回到属性的父元素，read() 才负责沿 XML 文档继续向前。