PHP8 的 Alpha 版本，過(guò)幾天就要發(fā)布了，其中包含了不少的新特性，當(dāng)然我自己認(rèn)為最重要的還是 JIT，這個(gè)我從 2013 年開(kāi)始參與，中間挫折無(wú)數(shù)，失敗無(wú)數(shù)后，終于要發(fā)布的東東。

不過(guò)，今天呢，我不打算談 JIT，等 PHP8 發(fā)布了以后，我再單獨(dú)寫(xiě)個(gè)類(lèi)似《深入理解 PHP8 之 JIT》系列來(lái)說(shuō)吧。

嘿嘿，今天呢，我想談?wù)?Attributes，為啥呢， 是昨天我看到很多群在轉(zhuǎn)發(fā)一個(gè)文章，叫做《理解 PHP8 中的 Attributes》，說(shuō)實(shí)在的，這篇文章應(yīng)該是直接從英文翻譯過(guò)來(lái)的，寫(xiě)的晦澀難懂，很多同學(xué)看完以后表示，看的一頭霧水，不知道在說(shuō)啥。

于是我想，就用一篇文章來(lái)簡(jiǎn)單說(shuō)說(shuō)這是個(gè)啥。

說(shuō)注解之前，先說(shuō)說(shuō)以前的注釋?zhuān)覀兘?jīng)常會(huì)在 PHP 的項(xiàng)目中，看到的一個(gè)東西，類(lèi)似如下的 @param 和 @see ：

/**  * @param Foo $argument  * @see https:/xxxxxxxx/xxxx/xxx.html  */      function dummy($Foo) {}

這個(gè)叫做注釋?zhuān)瑢?duì)于以前的 PHP 來(lái)說(shuō)，注釋中的 @param 和 @see 毫無(wú)意義，整個(gè)這一段會(huì)保存為一個(gè)函數(shù) / 方法的一個(gè)叫做 doc_comment 的字符串。

如果我們要分析這段注釋的含義，我們需要通過(guò)設(shè)計(jì)一些特定的語(yǔ)法，就比如栗子中的 @+name， 類(lèi)似 @param 一樣， 然后自己分析這段字符串，來(lái)提取對(duì)應(yīng)的信息。

比如我們要獲取 See 這個(gè)注釋的信息，我們需要做類(lèi)似:

$ref = new ReflectionFunction("dummy"); $doc = $ref->getDocComment(); $see = substr($doc, strpos($doc, "@see") + strlen("@see "));

這樣的字符串處理，相對(duì)比較麻煩，也比較容易出錯(cuò)。

而 Attributes 呢，其實(shí)就是把 “注釋” 升級(jí)為支持格式化內(nèi)容的 “注解”

比如上面的例子：

<<Params("Foo", "argument")>> <<See("https://xxxxxxxx/xxxx/xxx.html")>> function dummy($argument) {}

大家不要糾結(jié)這么寫(xiě)的意義是啥，從功能上來(lái)說(shuō)，現(xiàn)在你就可以通過(guò) Reflection 來(lái)獲取這段格式化的注解了，比如，我們現(xiàn)在要獲取 See 這個(gè)注解:

$ref = new ReflectionFunction("dummy");   var_dump($ref->getAttributes("See")[0]->getName()); var_dump($ref->getAttributes("See")[0]->getArguments());

會(huì)輸出:

string(3) "See" array(1) {   [0]=>   string(30) "https://xxxxxxxx/xxxx/xxx.html" }

當(dāng)然，還有稍微高級(jí)一點(diǎn)的用法，就是你可以定義一個(gè)所謂的 “注解類(lèi)”:

<?php <<phpAttribute>> class MyAttribute {      public function __construct($name, $value) {           var_dump($name);           var_dumP($value);      } }

然后， 你就可以寫(xiě)類(lèi)似， 注意其中的 newInstance 調(diào)用：

<<MyAttribute("See", "https://xxxxxxxx/xxxx/xxx.html")>> function dummy($argument) { } $ref = new ReflectionFunction("dummy");   $ref->getAttributes("MyAttribute")[0]->newInstance();

如果你跑這段代碼，你會(huì)看到 MyAttribute 的__construct 方法被調(diào)用了，調(diào)用傳遞的參數(shù)就是”See” 和”https://xxx”

明白了么， 就是你可以把一個(gè)注解 “實(shí)例化”， 然后，你就可以基于這個(gè)能力，來(lái)做自己的 “注釋即配置” 的設(shè)計(jì)。總結(jié)下 Attributes 的寫(xiě)法就是如下的形式:

<<Name>> <<Name(Arguments)>> <<Name(Argunment1, Arguments2, ArgumentN)>>   <<Name1(Argument), Name2(Argument), Name3(Argument)>>

然后你就可以通過(guò) PHP 的 Reflection 系列的方法，根據(jù) getAttributes (“Name”) 獲取對(duì)應(yīng)的注解， 進(jìn)一步你可以通過(guò)調(diào)用返回的注解的 getName 方法獲取名字，getArguments 方法獲取括號(hào)中的 Arguments。

再進(jìn)一步，如果 Name 是一個(gè)你自己定義的，帶有 phpAttriubtes 注解的類(lèi)， 你還可以調(diào)用 newInstance 方法，實(shí)現(xiàn)類(lèi)似”new Name (Arguments)” 的調(diào)用。

也許很多人會(huì)問(wèn)，這有什么卵用？

坦白說(shuō)，我一直對(duì)新特性無(wú)感，但這個(gè) Attributes，多少還是應(yīng)該有那么一點(diǎn)點(diǎn)吧。

推薦文章：《PHP8.0》