PHP CachingIterator 怎样启用完整缓存后按键读取

如果你想让 PHP 的 CachingIterator 在遍历过程中保留已经读过的值，再按数字下标取回它们，关键是构造时加入 CachingIterator::FULL_CACHE。随后调用 getCache() 可以拿到当前缓存数组，也可以通过数组访问语法读取指定下标；尚未遍历到的元素不会提前出现在缓存里。

官方地址：https://www.php.net/manual/en/cachingiterator.getcache.php

这个问题最容易踩的坑是把“底层迭代器里存在的元素”和“CachingIterator 已经缓存的元素”当成一回事。下面按一个需要回看前面结果的遍历场景拆开说明。

先打开 FULL_CACHE 开关

CachingIterator 接收一个内部迭代器和一个 flags 位掩码。只有 flags 包含 CachingIterator::FULL_CACHE 时，getCache() 才能返回完整缓存；不传这个标志直接调用，会抛出 BadMethodCallException。

默认的构造 flags 是 CALL_TOSTRING，它与完整缓存不是同一件事。要按键回读数据，必须显式传入完整缓存标志。

只读取已经遍历过的数据

完整缓存不是一次性复制源数据。缓存会随着迭代推进而增长：调用 next() 让内部迭代器继续向前，随后已经读取到的值才会进入缓存。换句话说，缓存下标代表“已经读过的数据位置”，不是对源集合的预加载索引。

next();
$iterator->next();

// 这里得到的是已经读取到的缓存项，不是整个源数组。
$cached = $iterator->getCache();
var_export($cached);
?>

如果业务需要从第一项开始按预期推进，通常先调用 rewind()，再用 valid() 判断当前位置是否有效。不要仅凭源数组的长度推断缓存已经准备完毕。

用 getCache 和下标按键取值

getCache() 返回一个数组，因此适合一次查看当前已缓存内容；$iterator[$key] 适合只取某一个下标。下标还没有被遍历到时，按键读取不会神奇地触发底层迭代，而是落到不存在的缓存索引上。

rewind();
if ($iterator->valid()) {
    $first = $iterator[0];
    echo $first, PHP_EOL;
}

// 先检查下标是否已存在，避免直接读取未缓存的位置。
$cache = $iterator->getCache();
if (array_key_exists(1, $cache)) {
    echo $cache[1], PHP_EOL;
}
?>

按键读取时建议先使用 getCache() 配合 array_key_exists() 做边界判断。这样可以区分“下标不存在”和“值本身是 null”，也能避免把未读取的数据误当成缓存结果。

把读取逻辑放进实际遍历

下面这个例子模拟输出当前订单，同时在遍历过程中回看已经缓存的第一项。示例重点是读取顺序：先让当前元素进入缓存，再读取缓存数组，而不是在构造后立即假设全部数据都可按键访问。

rewind();
while ($iterator->valid()) {
    // current() 是当前位置；getCache() 是已经读取过的值集合。
    $current = $iterator->current();
    $cache = $iterator->getCache();
    echo '当前：', $current, PHP_EOL;

    // 只有缓存中已有下标 0 时，才安全地回看第一项。
    if (array_key_exists(0, $cache)) {
        echo '首项：', $cache[0], PHP_EOL;
    }

    // next() 推进后，下一轮才会处理新的当前位置。
    $iterator->next();
}
?>

如果只是需要一次性查看已经读取的所有值，直接使用返回数组即可；如果还要持续遍历大集合，则应注意完整缓存会让内存占用随已读数据增长。

记住异常和内存边界

• 没有 FULL_CACHE：不要调用 getCache()，否则会触发 BadMethodCallException。
• 下标尚未遍历：先看 getCache() 或用 array_key_exists() 判断，不要把源迭代器长度当成缓存长度。
• 数据量很大：完整缓存会保留已读数据；只需要单向处理时，普通迭代通常更省内存。

因此，PHP CachingIterator 按键读取的完整做法可以概括为：构造时启用 FULL_CACHE，推进迭代让数据进入缓存，通过 getCache() 或下标读取，并在边界处先判断缓存是否已有目标键。

相关问题

getCache() 会返回还没有遍历到的元素吗？

不会。它返回当前已经进入缓存的元素，未遍历部分仍由内部迭代器持有。

为什么调用 getCache() 会抛 BadMethodCallException？

最常见原因是构造 CachingIterator 时没有传入 CachingIterator::FULL_CACHE。