詳解PHP的7個預定義接口

Posted on by

1. Traversable（遍歷）接口

該接口不能被類直接實現，如果直接寫瞭一個普通類實現瞭該遍歷接口，是會直接報致命的錯誤，提示使用 Iterator（迭代器接口）或者 IteratorAggregate（聚合迭代器接口）來實現，這兩個接口後面會介紹；所有通常情況下，我們隻是會用來判斷該類是否可以使用 foreach 來進行遍歷；

class Test implements Traversable
{
}
上面這個是錯誤示范，該代碼會提示這樣的錯誤：
Fatal error: Class Test must implement interface Traversable as part of either Iterator or
IteratorAggregate in Unknown on line 0

上面的大致意思是說如要實現這個接口，必須同Iterator或者IteratorAggregate來實現 正確的做法： 當我們要判斷一個類是否可以使用foreach來進行遍歷，隻需要判斷是否是traversable的實例

class Test
{
}
$test = new Test;
var_dump($test instanceOf Traversable);

2. Iterator（迭代器）接口

迭代器接口其實實現的原理就是類似指針的移動，當我們寫一個類的時候，通過實現對應的 5 個方法：key（），current（），next（），rewind（），valid（），就可以實現數據的迭代移動，具體看以下代碼

<?php
    class Test implements Iterator
    {
        private $key;
        private $val = [
            'one',
            'two',
            'three',
        ];

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

        public function current()
        {
            return $this->val[$this->key];
        }

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

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

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

    $test = new Test;

    $test->rewind();

    while($test->valid()) {
        echo $test->key . ':' . $test->current() . PHP_EOL;
        $test->next();
    }

## 該輸出結果 ：       

0: one

1: two

2: three

看瞭這個原理我們就知道，其實迭代的移動方式：rewind（）-> valid（）->key() -> current() -> next() -> valid（）-> key() ….-> valid();

好的，理解瞭上面，我們打開Iterator的接口，發現它是實現瞭Traversable（遍歷）接口的，接下來我們來證明下：

var_dump($test instanceOf Traversable);

結果返回的是true，證明這個類的對象是可以進行遍歷的。

foreach （$test as $key => $value）{
    echo $test->key . ':' . $test->current() . PHP_EOL;
}

這個的結果跟while循環實現的模式是一樣的。

3. IteratorAggregate（聚合迭代器） 接口

聚合迭代器和迭代器的原理是一樣的，隻不過聚合迭代器已經實現瞭迭代器原理，你隻需要實現一個 getIterator（）方法來實現迭代，具體看以下代碼

<?php
    class Test implements IteratorAggregate
    {
        public $one = 1;
        public $two = 2;
        public $three = 3;

        public function __construct()
        {
            $this->four = 4;
        }

        public function getIterator()
        {
            return new AraayIterator($this);
        }
    }

    $test = (new Test())->getIterator();
    $test->rewind();
    while($test->valid()) {
        echo $test->key() . ' : '  .  $test->current() . PHP_EOL;
        $test->next();
    }

    //從上面的代碼，我們可以看到我們將Test類的對象傳進去當做迭代器，通過while循環的話，我們必須通過調用getIterator（）方法獲取到迭代器對象，然後直接進行迭代輸出，而不需要去實現相關的key()等方法。
    //當然這個時候，我們肯定想知道是否可以直接從foreach進行迭代循環出去呢？那麼我們來打印一下結果

    $test = new Test;
    var_dump($test instanceOf Traversable);

    //結果是輸出bool true，所以我們接下來是直接用foreach來實現一下。

    $test = new Test;
  foreach($test as $key => $value) {
     echo $key . ' : ' . $value  .  PHP_EOL;
  }

 //接下來，我們看到是對對象進行迭代，這個時候我們是否可以數組進行迭代呢？

 class Test implements IteratorAggregate
 {
    public $data;

    public function __construct()
    {
        $this->data = [''one' =>  1 , 'two' => 2];
    }

    public function getIterator()
    {
        return new AraayIterator($this->data);
    }
 }

 //同理實現的方式跟對對象進行迭代是一樣的。

4.ArrayAccess（數組式訪問）接口

通常情況下，我們會看到 this [‘name’] 這樣的用法，但是我們知道，$this 是一個對象，是如何使用數組方式訪問的？答案就是實現瞭數據組訪問接口 ArrayAccess，具體代碼如下

<?php
    class Test implements ArrayAccess
    {
        public $container;

        public function __construct()
        {
            $this->container = [
                'one' => 1,
                'two' => 2,
                'three'  => 3,
            ];
        }

        public function offsetExists($offset)
        {
            return isset($this->container[$offset]);
        }

        public function offsetGet($offset)
        {
            return isset($this->container[$offset]) ? $this->container[$offset] : null;
        }

        public function offsetSet($offset, $value)
        {
            if (is_null($offset)) {
                $this->container[] = $value;
            } else {
                $this->container[$offset] = $value;
            }
        }

        public function offsetUnset($offset)
        {
            unset($this->container[$offset]);
        }
    }
   $test = new Test;
   var_dump(isset($test['one']));
   var_dump($test['two']);
   unset($test['two']);
   var_dump(isset($test['two']));
   $test['two'] = 22;
   var_dump($test['two']);
   $test[] = 4;
   var_dump($test);
   var_dump($test[0]);

   //當然我們也有經典的一個做法就是把對象的屬性當做數組來訪問

   class Test implements ArrayAccess
   {
        public $name;

        public function __construct()
        {
            $this->name = 'gabe';
        }

        public function offsetExists($offset)
        {
            return isset($this->$offset);
        }

        public function offsetGet($offset)
        {
            return isset($this->$offset) ? $this->$offset : null;
        }

        public function offsetSet($offset, $value)
        {
            $this->$offset = $value;
        }

        public function offsetUnset($offset)
        {
            unset($this->$offset);
        }
   }

  $test = new Test;
  var_dump(isset($test['name']));
  var_dump($test['name']);
  var_dump($test['age']);
  $test[1] = '22';
  var_dump($test);
  unset($test['name']);
  var_dump(isset($test['name']));
  var_dump($test);
  $test[] = 'hello world';
  var_dump($test);

5. Serializable （序列化）接口

通常情況下，如果我們的類中定義瞭魔術方法，sleep(),wakeup () 的話，我們在進行 serialize () 的時候，會先調用sleep () 的魔術方法，我們通過返回一個數組，來定義對對象的哪些屬性進行序列化，同理，我們在調用反序列化 unserialize () 方法的時候，也會先調用的wakeup（）魔術方法，我們可以進行初始化，如對一個對象的屬性進行賦值等操作；但是如果該類實現瞭序列化接口，我們就必須實現 serialize（）方法和 unserialize () 方法，同時sleep（）和wakeup () 兩個魔術方法都會同時不再支持，具體代碼看如下；

<?php
    class Test
    {
        public $name;
        public $age;

        public function __construct()
        {
            $this->name = 'gabe';
            $this->age = 25;
        }

        public function __wakeup()
        {
            var_dump(__METHOD__);
            $this->age++;
        }

        public function __sleep()
        {
            var_dump(__METHOD__);
            return ['name'];
        }
    }

    $test = new Test;
    $a = serialize($test);
    var_dump($a);
    var_dump(unserialize($a));

    //實現序列化接口，發現魔術方法失效瞭

   class Test implements Serializable
   {
    public $name;
    public $age;

    public function __construct()
    {
        $this->name = 'gabe';
        $this->age = 25;
    }

    public function __wakeup()
    {
        var_dump(__METHOD__);
        $this->age++;
    }

    public function __sleep()
    {
        var_dump(__METHOD__);
        return ['name'];
    }

    public function serialize()
    {
        return serialize($this->name);
    }

    public function unserialize($serialized)
    {
        $this->name = unserialize($serialized);
        $this->age = 1;
    }
}
$test = new Test;
$a = serialize($test);
var_dump($a);
var_dump(unserialize($a));

6. Closure 類

用於代表匿名函數的類，凡是匿名函數其實返回的都是 Closure 閉包類的一個實例，該類中主要有兩個方法，bindTo（）和 bind（），通過查看源碼，可以發現兩個方法是殊途同歸，隻不過是 bind () 是個靜態方法，具體用法看如下；

<?php
    $closure = function () {
        return 'hello world';
    }

    var_dump($closure);
    var_dump($closure());

通過上面的例子，可以看出第一個打印出來的是 Closure 的一個實例，而第二個就是打印出匿名函數返回的 hello world 字符串；接下來是使用這個匿名類的方法，這兩個方法的目的都是把匿名函數綁定一個類上使用；

bindTo()

<?php
namespace demo1;
    class Test {
        private $name = 'hello woeld';
    }

    $closure = function () {
        return $this->name;
    }

    $func = $closure->bindTo(new Test);
    $func();
    // 這個是可以訪問不到私有屬性的，會報出無法訪問私有屬性
    // 下面這個是正確的做法
    $func = $closure->bindTo(new Test, Test::class);
    $func();

namespace demo2;
    class Test
    {
        private statis $name = 'hello world';
    }

    $closure = function () {
        return self::$name;
    }
    $func = $closure->bindTo(null, Test::class);
    $func();

bind()

<?php
namespace demo1;
class Test
{
    private  $name = 'hello world';
}

$func = \Closure::bind(function() {
    return $this->name;
}, new Test, Test::class);

$func();

namespace demo2;
class Test
{
    private static  $name = 'hello world';
}

$func = \Closure::bind(function() {
    return self::$name;
}, null, Test::class);

$func()

7. Generator （生成器）

Generator 實現瞭 Iterator，但是他無法被繼承，同時也生成實例。既然實現瞭 Iterator，所以正如上文所介紹，他也就有瞭和 Iterator 相同的功能:rewind->valid->current->key->next…，Generator 的語法主要來自於關鍵字 yield。yield 就好比一次循環的中轉站，記錄本次的活動軌跡，返回一個 Generator 的實例。Generator 的優點在於，當我們要使用到大數據的遍歷，或者說大文件的讀寫，而我們的內存不夠的情況下，能夠極大的減少我們對於內存的消耗，因為傳統的遍歷會返回所有的數據，這個數據存在內存上，而 yield 隻會返回當前的值，不過當我們在使用 yield 時，其實其中會有一個處理記憶體的過程，所以實際上這是一個用時間換空間的辦法。

<?php
$start_time = microtime(true);
function xrange(int $num){
    for($i = 0; $i < $num; $i++) {
        yield $i;
    }
}
$generator = xrange(100000);
foreach ($generator as $key => $value) {
    echo $key . ': ' . $value . PHP_EOL;
}
echo 'memory: ' . memory_get_usage() . ' time: '. (microtime(true) - $start_time);

輸出：

memory: 388904 time: 0.12135100364685

<?php
$start_time = microtime(true);
function xrange(int $num){
    $arr = [];
    for($i = 0; $i < $num; $i++) {
        array_push($arr, $i);
    }
    return $arr;
}
$arr = xrange(100000);
foreach ($arr as $key => $value) {
    echo $key . ': ' . $value . PHP_EOL;
}
echo 'memory: ' . memory_get_usage() . ' time: '. (microtime(true) - $start_time);

輸出：

memory: 6680312 time: 0.10804104804993

以上就是詳解PHP的7個預定義接口的詳細內容，更多關於PHP的7個預定義接口的資料請關註WalkonNet其它相關文章！

推薦閱讀：