聊聊 PHP 8 新特性 Attributes
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,多少還是應該有那么一點點吧 ????
以上就是聊聊 PHP 8 新特性 Attributes的詳細內容,更多關于PHP 8 Attributes的資料請關注好吧啦網其它相關文章!
相關文章: