PHP8 的 Alpha 版本，過幾天就要釋出了，其中包含了不少的新特性，當然我自己認為最重要的還是 JIT，這個我從 2013 年開始參與，中間挫折無數，失敗無數後，終於要釋出的東東。

不過，今天呢，我不打算談 JIT，等 PHP8 釋出了以後，我再單獨寫個類似《深入理解 PHP8 之 JIT》系列來說吧。

嘿嘿，今天呢，我想談談 Attributes，為啥呢， 是昨天我看到很多群在轉發一個文章，叫做《理解 PHP8 中的 Attributes》，說實在的，這篇文章應該是直接從英文翻譯過來的，寫的晦澀難懂，很多同學看完以後表示，看的一頭霧水，不知道在說啥。

於是我想，就用一篇文章來簡單說說這是個啥。

說註解之前，先說說以前的註釋，我們經常會在 PHP 的專案中，看到的一個東西，類似如下的 @param 和 @see ：

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

這個叫做註釋，對於以前的 PHP 來說，註釋中的 @param 和 @see 毫無意義，整個這一段會儲存為一個函式 / 方法的一個叫做 doc_comment 的字串。

如果我們要分析這段註釋的含義，我們需要通過設計一些特定的語法，就比如栗子中的 @+name， 類似 @param 一樣， 然後自己分析這段字串，來提取對應的資訊。

比如我們要獲取 See 這個註釋的資訊，我們需要做類似:

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

這樣的字串處理，相對比較麻煩，也比較容易出錯。

而 Attributes 呢，其實就是把 “註釋” 升級為支援格式化內容的“註解”

比如上面的例子：

1.  <?php
2.  <<Params("Foo", "argument")>>
3.  <<See("https://xxxxxxxx/xxxx/xxx.html")>>
4.  function dummy($argument) {}
 

大家不要糾結這麼寫的意義是啥，從功能上來說，現在你就可以通過 Reflection 來獲取這段格式化的註解了，比如，我們現在要獲取 See 這個註解:

1.  $ref = new ReflectionFunction("dummy");

3.  var_dump($ref->getAttributes("See")[0]->getName());
4.  var_dump($ref->getAttributes("See")[0]->getArguments());

會輸出:

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

當然，還有稍微高階一點的用法，就是你可以定義一個所謂的 “註解類”:

1.  <?php
2.  <<phpAttribute>>
3.  class MyAttribute {
4.  public function __construct($name, $value) {
5.  var_dump($name);
6.  var_dumP($value);
7.  }
8.  }

然後， 你就可以寫類似， 注意其中的 newInstance 呼叫：

1.  <<MyAttribute("See", "https://xxxxxxxx/xxxx/xxx.html")>>
2.  function dummy($argument) {
3.  }
4.  $ref = new ReflectionFunction("dummy");

6.  $ref->getAttributes("MyAttribute")[0]->newInstance();

如果你跑這段程式碼，你會看到 MyAttribute 的__construct 方法被呼叫了，呼叫傳遞的引數就是”See” 和”https://xxx”

明白了麼， 就是你可以把一個註解 “例項化”， 然後，你就可以基於這個能力，來做自己的 “註釋即配置” 的設計。總結下 Attributes 的寫法就是如下的形式:

1.  <<Name>>
2.  <<Name(Arguments)>>
3.  <<Name(Argunment1, Arguments2, ArgumentN)>>

然後你就可以通過 PHP 的 Reflection 系列的方法，根據 getAttributes (“Name”) 獲取對應的註解， 進一步你可以通過呼叫返回的註解的 getName 方法獲取名字，getArguments 方法獲取括號中的 Arguments。

再進一步，如果 Name 是一個你自己定義的，帶有 phpAttriubtes 註解的類， 你還可以呼叫 newInstance 方法，實現類似”new Name (Arguments)” 的呼叫。

也許很多人會問，這有什麼卵用？

坦白說，我一直對新特性無感，但這個 Attributes，多少還是應該有那麼一點點吧。

轉載：www.laruence.com/2020/06/12/5902.h...

對PHP後端技術，對PHP架構技術感興趣的朋友，我的官方群1023755567點選此處，一起學習，相互討論。

群內已經有管理將知識體系整理好（原始碼，學習視訊等資料），歡迎加群免費領取。

部分內容截圖如下：