PHP - Iterator接口介绍

封面图 • 2025-10-23 • PHP

在 PHP 中，`Iterator` 接口是实现自定义迭代器的接口。它允许你创建一个可以使用 `foreach` 循环遍历的对象。通过实现 `Iterator` 接口，你可以控制对象如何被遍历，比如从数据库中逐条获取数据、从文件中读取行等。

---

## ✅ `Iterator` 接口简介

PHP 的 `Iterator` 接口定义了以下 5 个必须实现的方法：

```php
interface Iterator {
    public function current();
    public function key();
    public function next();
    public function rewind();
    public function valid();
}
```

---

## 🔍 各方法说明

| 方法       | 描述                                                                 |
|------------|----------------------------------------------------------------------|
| `current()` | 返回当前元素的值（即当前指针指向的元素）                            |
| `key()`     | 返回当前元素的键（索引或名称）                                      |
| `next()`    | 将指针移动到下一个元素                                              |
| `rewind()`  | 将指针重置到第一个元素（初始化）                                    |
| `valid()`   | 检查当前元素是否有效（即是否还有下一个元素）                        |

---

## 🧠 使用示例：实现一个简单的 `Iterator`

下面是一个使用 `Iterator` 接口的简单例子：

```php
class MyIterator implements Iterator {
    private $data = [];
    private $position = 0;

public function __construct(array $data) {
        $this->data = $data;
    }

public function current() {
        return $this->data[$this->position];
    }

public function key() {
        return $this->position;
    }

public function next() {
        $this->position++;
    }

public function rewind() {
        $this->position = 0;
    }

public function valid() {
        return isset($this->data[$this->position]);
    }
}

// 使用
$it = new MyIterator([1, 2, 3, 4, 5]);

foreach ($it as $key => $value) {
    echo "Key: $key, Value: $value\n";
}
```

**输出：**

```
Key: 0, Value: 1
Key: 1, Value: 2
Key: 2, Value: 3
Key: 3, Value: 4
Key: 4, Value: 5
```

---

## 📌 注意事项

- 实现 `Iterator` 接口时，必须实现所有 5 个方法。
- 这个接口非常适合需要 **延迟加载** 或 **动态生成数据** 的场景，比如从数据库查询结果集、读取大文件等。
- 如果你只是想让类支持 `foreach` 遍历，但不需要自定义逻辑，也可以使用 `Traversable` 接口（通常通过 `ArrayAccess` 或 `IteratorAggregate` 来实现）。

---

## 🔄 相关接口

除了 `Iterator`，PHP 还提供了其他与迭代相关的接口：

| 接口             | 用途                                     |
|------------------|------------------------------------------|
| `IteratorAggregate` | 提供一个 `getIterator()` 方法，用于返回一个 `Iterator` 对象 |
| `ArrayAccess`     | 允许对象像数组一样访问（如 `$obj['key']`） |
| `Countable`       | 允许对象使用 `count()` 函数              |

---

## ✅ 总结

- `Iterator` 接口是 PHP 中实现自定义迭代器的核心接口。
- 它提供了对对象内部数据进行遍历的控制能力。
- 适用于需要自定义遍历逻辑的场景，如数据库分页、文件读取等。

如果你有更具体的应用场景（例如数据库查询、文件处理等），我可以帮你写一个更详细的例子 😊