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點擊此處,一起學習,相互討論。
群內已經有管理將知識體系整理好(源碼,學習視頻等資料),歡迎加群免費領取。
部分內容截圖如下:
