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這個註解:
$ref = new ReflectionFunction("dummy"); 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" }
當然,還有稍微高階一點的用法,就是你可以定義一個所謂的「註解類」:
<?php <<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 = new ReflectionFunction("dummy"); $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,多少還是應該有那麼一點點吧