包装迭代器是通过封装另一个迭代器来增强其遍历行为的设计模式，如FilterIterator过滤、LimitIterator限数、CallbackFilterIterator映射等，实现功能扩展而不修改原始数据结构。
PHP中的包装迭代器（Iterator Iterator）指的是通过一个迭代器去封装或“包装”另一个迭代器，从而在不改变原始数据结构的前提下，增强或修改其遍历行为。这种设计模式常用于对已有迭代器的功能进行扩展，比如过滤、映射、限制数量等。
什么是包装迭代器
包装迭代器本身并不直接管理数据，而是持有一个内部的迭代器对象，并在其基础上添加额外逻辑。它实现Iterator接口，对外表现得像一个正常的可遍历对象，但每次调用如current()、next()等方法时，会先对底层迭代器的结果做处理。
常见用途包括：
- 跳过某些不符合条件的元素（如
FilterIterator） - 限制返回的元素个数（如
LimitedIterator） - 修改输出格式或值（如
CallbackFilterIterator） - 递归遍历嵌套结构（如
RecursiveIteratorIterator）
如何理解它的作用
可以把包装迭代器想象成一个“中间层”。你有一个原始的数据源（比如数组或目录文件），原本可以直接遍历，但现在你想加点规则——例如只取偶数、只读前5个、或者按名字排序后再输出。这时不需要重写整个遍历逻辑，只需用一个包装类把原迭代器包起来，在遍历时自动应用这些规则。
立即学习“PHP免费学习笔记（深入）”；
举个简单例子：
$data = new ArrayIterator([1, 2, 3, 4, 5]);
$filtered = new CallbackFilterIterator($data, function($value) {
return $value > 2;
});
foreach ($filtered as $item) {
echo $item; // 输出 3, 4, 5
}
这里CallbackFilterIterator就是包装了ArrayIterator，在每次获取元素时执行回调判断是否保留。
常见的内置包装迭代器
- FilterIterator：根据条件过滤元素
- LimitIterator：限制返回的范围（偏移和数量）
- MapIterator（需手动实现或使用第三方）：转换每个元素的值
- AppendIterator：将多个迭代器串联成一个
- RegexIterator：用正则表达式筛选条目
自定义包装迭代器示例
你可以自己写一个简单的包装器来加深理解：
class SquareIterator implements Iterator {
private $inner;
public function __construct(Iterator $iterator) {
$this->inner = $iterator;
}
public function current() {
return $this->inner->current() ** 2;
}
public function key() {
return $this->inner->key();
}
public function next() {
$this->inner->next();
}
public function rewind() {
$this->inner->rewind();
}
public function valid() {
return $this->inner->valid();
}}
// 使用
$array = new ArrayIterator([1, 2, 3]);
$squared = new SquareIterator($array);
foreach ($squared as $val) {
echo $val . " "; // 输出 1 4 9
}
这个例子中，SquareIterator没有改变原始数据，只是把每个值平方后返回，体现了包装的核心思想：增强而非替代。
基本上就这些。理解包装迭代器的关键是抓住“委托+增强”的模式：把遍历操作交给内部迭代器，自己负责附加逻辑。这种方式让代码更灵活、可复用，也符合单一职责原则。
