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

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

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

于是我想，就用一篇文章來簡單說說這是個(gè)啥。

說注解之前，先說說以前的注釋，我們經(jīng)常會(huì)在 PHP 的項(xiàng)目中，看到的一個(gè)東西，類似如下的 @param 和 @see ：

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

這個(gè)叫做注釋，對(duì)于以前的 PHP 來說，注釋中的 @param 和 @see 毫無意義，整個(gè)這一段會(huì)保存為一個(gè)函數(shù) / 方法的一個(gè)叫做 doc_comment 的字符串。

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

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

$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àn)在你就可以通過 Reflection 來獲取這段格式化的注解了，比如，我們現(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è)所謂的 “注解類”:

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

然后， 你就可以寫類似， 注意其中的 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è)能力，來做自己的 “注釋即配置” 的設(shè)計(jì)?？偨Y(jié)下 Attributes 的寫法就是如下的形式:

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

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

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

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

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

推薦文章：《PHP8.0》