创意电子

标题: PHP的SPL扩展库（三）迭代器 [打印本页]

作者: 硬核项目经理 时间: 2021-10-19 11:22
标题: PHP的SPL扩展库（三）迭代器

关于迭代器，我们在之前筹划模式相关的文章中已经讲过迭代器具体是个啥，而且也利用过 SPL 的例子来演示过，要是没有看过之前的文章的可以穿越归去看一下哦！PHP筹划模式之迭代器模式：https://mp.weixin.qq.com/s/uycac0OXYYjAG1BlzTUjsw。

因此，对于迭代器的概念，我们这里就不会多说了，本日的主要内容就是来了解一下 SPL 扩展中都包含哪些迭代器以及它们的功能效果。另外，上一篇文章中我们接触过的数组迭代器 ArrayIterator 由于已经学习过了，也就不放在这里讲了。别的另有文件目次相关的迭代器，也会放在和其相关的文件目次利用的文章中讲解，包罗下面学习的这些迭代器另有不少都有相对应的递归式的迭代器，比如我们下面要讲到的 CachingIterator 、 FilterIterator 等等，都有它们对应的 RecursiveCachingIterator 、 RecursiveFilterIterator 类，这个大家就自己去研究下吧，带递归迭代器，也就是多了两个方法 getChildren() 和 hasChildren() 而已，末了我们还会实现一个自己的迭代器类，其中就会讲到递归这块。

IteratorIterator 包装迭代器

首先我们来看一下什么是包装迭代器。它本身也是个迭代器，但是在实例化的时候，又必须给他再通报进来一个迭代器并保存在内部，是一个内部迭代器 InnerIterator 。对于它自身的那些迭代器接口函数来说，其实都是转发调用的那个内部迭代器相关的利用函数。感觉上其实就有点像是一个装饰器模式，我们可以通过继续 IteratorIterator 来实现对原有迭代器功能的升级。

$iterator = new IteratorIterator(new ArrayIterator([1, 2, 3]));$iterator->rewind();while ($iterator->valid()) { echo $iterator->key(), ": ", $iterator->current(), PHP_EOL; $iterator->next();}// 0: 1// 1: 2// 2: 3

从代码中可以看出，它的构造参数必须还得是一个迭代器，本身的参数署名就是需要一个实现了 Traversable 接口的对象。Traversable 接口是所有迭代器所必须要实现的接口。

class OutIterator extends IteratorIterator{ public function rewind() { echo __METHOD__, PHP_EOL; return parent::rewind(); } public function valid() { echo __METHOD__, PHP_EOL; return parent::valid(); } public function current() { echo __METHOD__, PHP_EOL; return parent::current() . '_suffix'; } public function key() { echo __METHOD__, PHP_EOL; return parent::key(); } public function next() { echo __METHOD__, PHP_EOL; return parent::next(); } public function getInnerIterator() { echo __METHOD__, PHP_EOL; return parent::getInnerIterator(); }}$iterator = new OutIterator(new ArrayIterator([1, 2, 3]));foreach ($iterator as $k => $v) { echo $k, ': ', $v, PHP_EOL;}// OutIterator::rewind// OutIterator::valid// OutIterator::current// OutIterator::key// 0: 1_suffix// OutIterator::next// OutIterator::valid// OutIterator::current// OutIterator::key// 1: 2_suffix// OutIterator::next// OutIterator::valid// OutIterator::current// OutIterator::key// 2: 3_suffix// OutIterator::next// OutIterator::valid

我们自己写了一个 OutIterator 类并继续自 IteratorIterator 类，然后重写所有迭代器相关的方法函数。在这些函数中，增加一些输出调试信息，末了通过 foreach 来遍历迭代器。可以看出，foreach 在判定对象是否可迭代后，就会像我们利用 while 遍历迭代器一样地去调用对应的迭代器方法函数。这个例子相称地直观，也非常有助于我们明白迭代器这堆方法函数到底在干嘛。

var_dump($iterator->getInnerIterator());// object(ArrayIterator)#5 (1) {// ["storage":"ArrayIterator":private]=>// array(3) {// [0]=>// int(1)// [1]=>// int(2)// [2]=>// int(3)// }// }

通过 getInerIterator() 方法我们就可以得到包装迭代器内部的那个迭代器对象。这里很清晰地就能看到我们给它内部放置的那个迭代器相关的信息。

接下来，我们再学习一些派生自 IteratorIterator 类的迭代器。也就是说，它们都是继续自 IteratorIterator 这个包装迭代器的，并在它的基础之上又增加了不少别致的功能。

AppendIterator 追加迭代器

追加迭代器，很奇怪的名字，先来看看它是做啥的。

$appendIterator = new AppendIterator();$appendIterator->append(new ArrayIterator([1, 2, 3]));$appendIterator->append(new ArrayIterator(['a' => 'a1', 'b' => 'b1', 'c' => 'c1']));var_dump($appendIterator->getIteratorIndex()); // int(0)foreach ($appendIterator as $k => $v) { echo $k, ': ', $v, PHP_EOL; echo 'iterator index: ', $appendIterator->getIteratorIndex(), PHP_EOL;}// 0: 1// iterator index: 0// 1: 2// iterator index: 0// 2: 3// iterator index: 0// a: a1// iterator index: 1// b: b1// iterator index: 1// c: c1// iterator index: 1var_dump($appendIterator->getIteratorIndex()); // NULL

是的，你没看错，这个追加迭代器的功能就是可以在它里面保存多个内部迭代器。我们可以通过 append() 方法不断地添加，通过 getIteratorIndex() 可以查看到当前利用或遍历到的是哪个一个内部迭代器。

如果要获取内部迭代器对象的话，虽然也有继续自 IteratorIterator 的 getInnerIterator() 方法，但最好利用另一个方法。

var_dump($appendIterator->getArrayIterator());// object(ArrayIterator)#2 (1) {// ["storage":"ArrayIterator":private]=>// array(2) {// [0]=>// object(ArrayIterator)#7 (1) {// ["storage":"ArrayIterator":private]=>// array(3) {// [0]=>// int(1)// [1]=>// int(2)// [2]=>// int(3)// }// }// [1]=>// object(ArrayIterator)#9 (1) {// ["storage":"ArrayIterator":private]=>// array(3) {// ["a"]=>// string(2) "a1"// ["b"]=>// string(2) "b1"// ["c"]=>// string(2) "c1"// }// }// }// }

getArrayIterator() 可以一个数组形式的聚集来返回所有的内部迭代器。

CachingIterator 缓存迭代器

从英文名字就可以看出来，缓存迭代器。

$cachingIterator = new CachingIterator(new ArrayIterator([1, 2, 3]), CachingIterator::FULL_CACHE);var_dump($cachingIterator->getCache());// array(0) {// }foreach ($cachingIterator as $c) {}var_dump($cachingIterator->getCache());// array(3) {// [0]=>// int(1)// [1]=>// int(2)// [2]=>// int(3)// }

它比较有特色的就是这个 getCache() 方法，从上面的测试代码中大家看出什么题目了吗？没错，当我们遍历一次迭代器之后，内部迭代器的数据信息会缓存到 getCache() 这个方法里面返回的数组中。我们在遍历之前调用 getCache() 方法是没有任何内容的。另外，通过构造参数的第二个参数，我们可以指定缓存数据的信息内容，在这里我们利用的是 CachingIterator::FULL_CACHE ，也就是缓存全部内容。

FilterIterator 过滤迭代器

过滤这个词熟悉不，array_filter() 这个函数也是针对数组举行过滤利用的。同样地，FilterIterator 迭代器也是实现类似的效果。不外在学习利用这个 FilterIterator 之前，我们先学习一下它的两个派生类。

$callbackFilterIterator = new CallbackFilterIterator(new ArrayIterator([1, 2, 3, 4]), function ($current, $key, $iterator) { echo $key, ': ', $current, PHP_EOL; if ($key == 0) { var_dump($iterator); } if ($current % 2 == 0) { return true; } return false;});foreach ($callbackFilterIterator as $c) { echo 'foreach: ', $c, PHP_EOL;}// 0: 1// object(ArrayIterator)#13 (1) {// ["storage":"ArrayIterator":private]=>// array(4) {// [0]=>// int(1)// [1]=>// int(2)// [2]=>// int(3)// [3]=>// int(4)// }// }// 1: 2// foreach: 2// 2: 3// 3: 4// foreach: 4

CallbackFilterIterator 迭代器是通过我们在构造参数的第二个参数指定的回调函数来举行过滤利用的一个迭代器。如果要让数据通过，返回 true ，否则就返回 false 。先讲这个迭代器正是由于它和 array_filter() 着实是太像了。array_filter() 也是一样的通过一个回调函数来举行过滤判定的。

$regexIterator = new RegexIterator(new ArrayIterator(['test1', 'test2', 'opp1', 'test3']), '/^(test)(\d+)/', RegexIterator::MATCH);var_dump(iterator_to_array($regexIterator));// array(3) {// [0]=>// string(5) "test1"// [1]=>// string(5) "test2"// [3]=>// string(5) "test3"// }$regexIterator = new RegexIterator(new ArrayIterator(['test1', 'test2', 'opp1', 'test3']), '/^(test)(\d+)/', RegexIterator::REPLACE);$regexIterator->replacement = 'new $2$1'; var_dump(iterator_to_array($regexIterator));// array(3) {// [0]=>// string(9) "new 1test"// [1]=>// string(9) "new 2test"// [3]=>// string(9) "new 3test"// }

RegexIterator 信赖也不消多解释了，它就是通过正则表达式来举行过滤判定的。在这里需要注意的是，我们利用了一个 iterator_to_array() 函数，它也是 SPL 中的一个函数，作用就是将迭代器转换为数组，其实也就是解决我们都要写 foreach 大概 while 循环来演示的贫苦。

通过上面两个 FilterIterator 的派生类的学习，信赖大家对于这个过滤迭代器更加有爱好了。不外，这个原始的 FilterIterator 是一个抽象类哦，也就是说，它是不能直接实例化的，我们只能去再写一个类来继续它，并且要实现它的一个焦点方法 accept() 。

class MyFilterIterator extends FilterIterator{ public function accept(){ echo __METHOD__, PHP_EOL; if($this->current()%2==0){ return true; } return false; }}$myFilterIterator = new MyFilterIterator(new ArrayIterator([1,2,3,4]));var_dump(iterator_to_array($myFilterIterator));// MyFilterIterator::accept// MyFilterIterator::accept// MyFilterIterator::accept// MyFilterIterator::accept// array(2) {// [1]=>// int(2)// [3]=>// int(4)// }

不少小伙伴一定已经明确了，不管是上面的 CallbackFilterIterator 还是 RegexIterator ，都是实现了 FilterIterator 的一个实现类，它们都重写了 accept() 方法。它们通过构造函数的来通报需要的数据，在焦点利用的过程中 CallbackFilterIterator 就是在 accept() 中调用了那个通报进来的回调方法，而 RegexIterator 则是在 accept() 中对内部迭代器的数据举行了正则表达式的判定。

InfiniteIterator 无限迭代器

无限迭代器？什么鬼，貌似很高大上。这是一个坑，要小心哦。

$infinateIterator = new InfiniteIterator(new ArrayIterator([1,2,3,4]));$i = 20;foreach($infinateIterator as $k=>$v){ echo $k, ': ', $v, PHP_EOL; $i--; if($i // int(1)// [1]=>// int(2)// }$limitIterator = new LimitIterator(new ArrayIterator([1,2,3,4]),1,3);var_dump(iterator_to_array($limitIterator));// array(3) {// [1]=>// int(2)// [2]=>// int(3)// [3]=>// int(4)// }NoRewindIterator 无重回迭代器

末了一个要介绍的 IteratorIterator 系列中的迭代器就是这个 NoRewindIterator 。同样地从名字中我们可以看出一些端倪，那就是这个迭代器是没有 rewind() 方法的，大概说，这个方法是不起作用的。

$noRewindIterator = new NoRewindIterator(new ArrayIterator([1,2,3,4]));var_dump(iterator_to_array($noRewindIterator));// array(4) {// [0]=>// int(1)// [1]=>// int(2)// [2]=>// int(3)// [3]=>// int(4)// }$noRewindIterator->rewind();var_dump(iterator_to_array($noRewindIterator));// array(0) {// }

前面我们看到过，在 foreach() 时，每次遍历开始时都会调用 rewind() 方法让数据指针回到最顶部。同样地，iterator_to_array() 方法在其内部实现也是这样类似的步骤。但如果是 NoRewindIterator 的话，第二次遍历就不会有内容了，由于它的 rewind() 方法是不生效的，大概说是一个空的方法。

大家可以算大尝试用 while() 循环那种方式来测试一下，比利用 iterator_to_array() 更加清晰一些。

MultipleIterator 多并行迭代器

走出了 IteratorIterator 之后，我们来看一个和它没什么关系的迭代器，也就是说，这个迭代器没有继续大概利用 IteratorIterator 相关的方法函数内容。

从名字来说，Multiple 是多个的意思，岂非是内部放了多个迭代器？这不是和 AppendIterator 一样了。好吧，我承认，它确着实内部保存了一些迭代器，但注意，这些不是内置迭代器，和 IteratorIterator 是差别的哦。另外，它的表现形式也和 AppendIterator 差别。

$multipleIterator = new MultipleIterator();$multipleIterator->attachIterator(new ArrayIterator([1,2,3,4]));$multipleIterator->attachIterator(new ArrayIterator(['a' => 'a1', 'b' => 'b1', 'c' => 'c1']));$arr1 = new ArrayIterator(['a', 'b', 'c']);$arr2 = new ArrayIterator(['d', 'e', 'f', 'g', 'h']);$multipleIterator->attachIterator($arr1);$multipleIterator->attachIterator($arr2);var_dump($multipleIterator->containsIterator($arr1)); // bool(true)$multipleIterator->detachIterator($arr1);var_dump($multipleIterator->containsIterator($arr1)); // bool(false)// iterator_to_array($multipleIterator);foreach($multipleIterator as $k=>$v){ var_dump($k); var_dump($v);}// array(3) {// [0]=>// int(0)// [1]=>// string(1) "a"// [2]=>// int(0)// }// array(3) {// [0]=>// int(1)// [1]=>// string(2) "a1"// [2]=>// string(1) "a"// }// array(3) {// [0]=>// int(1)// [1]=>// string(1) "b"// [2]=>// int(1)// }// array(3) {// [0]=>// int(2)// [1]=>// string(2) "b1"// [2]=>// string(1) "b"// }// array(3) {// [0]=>// int(2)// [1]=>// string(1) "c"// [2]=>// int(2)// }// array(3) {// [0]=>// int(3)// [1]=>// string(2) "c1"// [2]=>// string(1) "e"// }

我们可以通过 attachIterator() 添加迭代器，通过 containsIterator() 判定指定的迭代器是否存在，也可以通过 detachIterator() 删除某个迭代器。不外最主要的特点还是在遍历的结果。

不管是 key() 还是 current() ，返回的数据都是一个数组。其实这个数组就是每个迭代器对应的内容，比如第一个 key() 返回的是第一个迭代器的下标 0 的位置，第二个迭代器下标 a 和第三个迭代器下标 0 的位置。也就是说，它一次返回了所有迭代器第一个位置的下标信息。同理，current() 返回的也是当前这个位置的所有数据信息。

另外，我们可以看到，差别的迭代器的内部数据数量是差别的，MultipleIterator 只会以最少的那条数据的数量举行返回，这个大家可以自己尝试下哦。

自己实现一个迭代器类

讲了那么多迭代器，我们要不要自己也来简朴地实现一个可以让 count() 生效的，并且有递归实现功能的，可以设置游标的迭代器。

class NewIterator implements Countable, RecursiveIterator, SeekableIterator { private $array = []; public function __construct($arr = []){ $this->array = $arr; } // Countable public function count(){ return count($this->array); } // RecursiveIterator public function hasChildren(){ if(is_array($this->current())){ return true; } return false; } // RecursiveIterator public function getChildren(){ if(is_array($this->current())){ return new ArrayIterator($this->current()); } return null; } // Seekable public function seek($position) { if (!isset($this->array[$position])) { throw new OutOfBoundsException("invalid seek position ($position)"); } $this->position = $position; } public function rewind() { $this->position = 0; } public function current() { return $this->array[$this->position]; } public function key() { return $this->position; } public function next() { ++$this->position; } public function valid() { return isset($this->array[$this->position]); }}$newIterator = new NewIterator([1,2,3,4, [5,6,7]]);var_dump(iterator_to_array($newIterator));// array(5) {// [0]=>// int(1)// [1]=>// int(2)// [2]=>// int(3)// [3]=>// int(4)// [4]=>// array(3) {// [0]=>// int(5)// [1]=>// int(6)// [2]=>// int(7)// }// }var_dump(count($newIterator));// int(5)$newIterator->rewind();while($newIterator->valid()){ if($newIterator->hasChildren()){ var_dump($newIterator->getChildren()); } $newIterator->next();}// object(ArrayIterator)#37 (1) {// ["storage":"ArrayIterator":private]=>// array(3) {// [0]=>// int(5)// [1]=>// int(6)// [2]=>// int(7)// }// }$newIterator->seek(2);while($newIterator->valid()){ var_dump($newIterator->current()); $newIterator->next();}// int(3)// int(4)// array(3) {// [0]=>// int(5)// [1]=>// int(6)// [2]=>// int(7)// }

关于代码不多解释了，注释里也有说明，最主要的就是要实现 Countable, RecursiveIterator, SeekableIterator 这三个接口。它们分别对应的就是 count 能力、递归能力、设置游标的能力。

总结

东西不少吧，各种迭代器的实现可以说是 SPL 中的一个非常重要的内容。除了本日介绍的这些之外，另有别的一些迭代器我们将在相关的文章中独立讲解。光是本日的内容估计就不好消化了，抓紧吸收吧，飙车还在继续哦！

测试代码：

https://github.com/zhangyue0503/dev-blog/blob/master/php/2021/01/source/5.PHP的SPL扩展库（三）迭代器.php

参考文档：

https://www.php.net/manual/zh/spl.iterators.php

欢迎光临创意电子 (https://wxcydz.cc/)