全方位解讀 PHP 8 新特性: Attributes (注解)


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點擊此處,一起學習,相互討論。

群內已經有管理將知識體系整理好(源碼,學習視頻等資料),歡迎加群免費領取。

部分內容截圖如下:

學習資料、文檔、電子書籍、視頻、面試題 點擊鏈接獲取​shimo.im

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM