PHP SPL 迭代器 Aggregate 接口，自定义对象支持 foreach 遍历-php教程-PHP中文网

实现 iteratoraggregate 接口是让自定义 php 对象支持 foreach 遍历最轻量、最常用的方式，只需实现 getiterator(): traversable 方法并返回 arrayiterator 或生成器等可遍历对象。

php spl 迭代器 aggregate 接口，自定义对象支持 foreach 遍历

要让自定义 PHP 对象支持 foreach 遍历，最轻量、最常用的方式就是实现 IteratorAggregate 接口。它不要求你手动写一堆迭代逻辑（比如 current()、next() 等方法），而是把遍历责任委托给一个已有的迭代器对象——比如 ArrayIterator 或生成器。

IteratorAggregate 的核心作用

这个接口只有一个必须实现的方法：getIterator(): Traversable。它的意义很明确：告诉 PHP，“当有人对这个对象用 foreach 时，请用我返回的这个可遍历对象来执行遍历”。

不强制暴露内部结构，封装性好
复用标准迭代器（如 ArrayIterator、ArrayObject），避免重复造轮子
比直接实现 Iterator 接口更简洁，适合大多数数据容器类

典型实现方式：用 ArrayIterator 包装属性

如果你的对象本质是“带属性的数据容器”，最自然的做法是把公开属性转成数组，再交给 ArrayIterator 处理：

class UserCollection implements IteratorAggregate {
    private array $users = [];

    public function add(string $name): void {
        $this->users[] = $name;
    }

    public function getIterator(): Traversable {
        return new ArrayIterator($this->users);
    }
}

这样就能直接 foreach：

Openclaw Gateway Guardian

OpenClaw网关守护 - 自动监控、保护与重启OpenClaw网关服务，防止网关停止、崩溃或消失。

下载

$coll = new UserCollection();
$coll->add('Alice');
$coll->add('Bob');

foreach ($coll as $name) {
    echo $name . "\n"; // 输出 Alice, Bob
}

进阶用法：返回生成器（Generator）

如果遍历逻辑较复杂（比如需要动态计算、过滤或延迟加载），可以用匿名函数 + yield 返回生成器：

public function getIterator(): Traversable {
    return (function () {
        foreach ($this->users as $index => $name) {
            if (strlen($name) > 3) { // 只遍历长度大于 3 的名字
                yield $index => $name;
            }
        }
    })();
}

生成器天然符合 Traversable，无需额外包装，内存友好且逻辑清晰。