PHP8的Alpha版本,過幾天就要發布了,其中包含了不少的新特性,當然我自己認為最重要的還是JIT,這個我從2013年開始參與,中間挫折無數,失敗無數後,終於要發布的東東。
不過,今天呢,我不打算談JIT,等PHP8發布了以後,我再單獨寫個類似《深入理解PHP8之JIT》系列來說吧。
嘿嘿,今天呢,我想談談Attributes,為啥呢, 是昨天我看到很多群在轉發一個文章,叫做《理解PHP8中的Attributes》,說實在的,這篇文章應該是直接從英文翻譯過來的,寫的晦澀難懂,很多同學看完以後表示,看的一頭霧水,不知道在說啥。
於是我想,就用一篇文章來簡單說說這是個啥。
說註解之前,先說說以前的注釋,我們經常會在PHP的項目中,看到的一個東西,類似如下的@param 和 @see :
/*** @param Foo $argument * @see https:/xxxxxxxx/xxxx/xxx.html */ function dummy($Foo) {}
這個叫做注釋,對於以前的PHP來說,注釋中的@param和@see毫無意義,整個這一段會保存為一個函數/方法的一個叫做doc_comment的字符串。
如果我們要分析這段注釋的含義,我們需要通過設計一些特定的語法,就比如慄子中的@+name, 類似@param一樣, 然後自己分析這段字符串,來提取對應的信息。
比如我們要獲取See這個注釋的信息,我們需要做類似:
$ref = new ReflectionFunction("dummy");$doc = $ref->getDocComment();$see = substr($doc, strpos($doc, "@see") + strlen("@see "));
這樣的字符串處理,相對比較麻煩,也比較容易出錯。
而Attributes呢,其實就是把「注釋」升級為支持格式化內容的「註解」
比如上面的例子:
<?php<<Params("Foo", "argument")>><<See("https://xxxxxxxx/xxxx/xxx.html")>>function dummy($argument) {}
大家不要糾結這麼寫的意義是啥,從功能上來說,現在你就可以通過Reflection來獲取這段格式化的註解了,比如, 我們現在要獲取See這個註解:
var_dump($ref->getAttributes("See")[0]->getName());var_dump($ref->getAttributes("See")[0]->getArguments());
會輸出:
string(3) "See"array(1) {[0]=> string(30) "https://xxxxxxxx/xxxx/xxx.html"}
當然,還有稍微高級一點的用法,就是你可以定義一個所謂的「註解類」:
<<phpAttribute>>class MyAttribute {public function __construct($name, $value) { var_dump($name); var_dumP($value); }
然後, 你就可以寫類似, 注意其中的newInstance調用:
<<MyAttribute("See", "https://xxxxxxxx/xxxx/xxx.html")>>function dummy($argument) {$ref->getAttributes("MyAttribute")[0]->newInstance();
如果你跑這段代碼,你會看到MyAttribute的__construct方法被調用了, 調用傳遞的參數就是」See」和」https://xxx」
明白了麼, 就是你可以把一個註解「實例化」, 然後,你就可以基於這個能力,來做自己的「注釋即配置」的設計。
總結下Attributes的寫法就是如下的形式:
<<Name>><<Name(Arguments)>><<Name(Argunment1, Arguments2, ArgumentN)>>
然後你就可以通過PHP的Reflection系列的方法,根據getAttributes("Name")獲取對應的註解, 進一步你可以通過調用返回的註解的getName方法獲取名字,getArguments方法獲取括號中的Arguments。
再進一步,如果Name是一個你自己定義的, 帶有phpAttriubtes註解的類, 你還可以調用newInstance方法,實現類似"new Name(Arguments)"的調用。
也許很多人會問,這有什麼卵用?
坦白說,我一直對新特性無感,但這個Attributes,多少還是應該有那麼一點點吧