PHP8 的 Alpha 版本,過(guò)幾天就要發(fā)布了,其中包含了不少的新特性,當(dāng)然我自己認(rèn)為最重要的還是 JIT,這個(gè)我從 2013 年開(kāi)始參與,中間挫折無(wú)數(shù),失敗無(wú)數(shù)后,終于要發(fā)布的東東。
創(chuàng)新互聯(lián)公司堅(jiān)持“要么做到,要么別承諾”的工作理念,服務(wù)領(lǐng)域包括:網(wǎng)站設(shè)計(jì)制作、成都網(wǎng)站設(shè)計(jì)、企業(yè)官網(wǎng)、英文網(wǎng)站、手機(jī)端網(wǎng)站、網(wǎng)站推廣等服務(wù),滿足客戶于互聯(lián)網(wǎng)時(shí)代的武山網(wǎng)站設(shè)計(jì)、移動(dòng)媒體設(shè)計(jì)的需求,幫助企業(yè)找到有效的互聯(lián)網(wǎng)解決方案。努力成為您成熟可靠的網(wǎng)絡(luò)建設(shè)合作伙伴!不過(guò),今天呢,我不打算談 JIT,等 PHP8 發(fā)布了以后,我再單獨(dú)寫(xiě)個(gè)類似《深入理解 PHP8 之 JIT》系列來(lái)說(shuō)吧。
嘿嘿,今天呢,我想談?wù)?Attributes,為啥呢, 是昨天我看到很多群在轉(zhuǎn)發(fā)一個(gè)文章,叫做《理解 PHP8 中的 Attributes》,說(shuō)實(shí)在的,這篇文章應(yīng)該是直接從英文翻譯過(guò)來(lái)的,寫(xiě)的晦澀難懂,很多同學(xué)看完以后表示,看的一頭霧水,不知道在說(shuō)啥。
于是我想,就用一篇文章來(lái)簡(jiǎn)單說(shuō)說(shuō)這是個(gè)啥。
說(shuō)注解之前,先說(shuō)說(shuō)以前的注釋,我們經(jīng)常會(huì)在 PHP 的項(xiàng)目中,看到的一個(gè)東西,類似如下的 @param 和 @see :
/** * @param Foo $argument * @see https:/xxxxxxxx/xxxx/xxx.html */ function dummy($Foo) {}
這個(gè)叫做注釋,對(duì)于以前的 PHP 來(lái)說(shuō),注釋中的 @param 和 @see 毫無(wú)意義,整個(gè)這一段會(huì)保存為一個(gè)函數(shù) / 方法的一個(gè)叫做 doc_comment 的字符串。
如果我們要分析這段注釋的含義,我們需要通過(guò)設(shè)計(jì)一些特定的語(yǔ)法,就比如栗子中的 @+name, 類似 @param 一樣, 然后自己分析這段字符串,來(lái)提取對(duì)應(yīng)的信息。
比如我們要獲取 See 這個(gè)注釋的信息,我們需要做類似:
$ref = new ReflectionFunction("dummy"); $doc = $ref->getDocComment(); $see = substr($doc, strpos($doc, "@see") + strlen("@see "));
這樣的字符串處理,相對(duì)比較麻煩,也比較容易出錯(cuò)。
而 Attributes 呢,其實(shí)就是把 “注釋” 升級(jí)為支持格式化內(nèi)容的 “注解”
比如上面的例子:
<> < > function dummy($argument) {}
大家不要糾結(jié)這么寫(xiě)的意義是啥,從功能上來(lái)說(shuō),現(xiàn)在你就可以通過(guò) Reflection 來(lái)獲取這段格式化的注解了,比如,我們現(xiàn)在要獲取 See 這個(gè)注解:
$ref = new ReflectionFunction("dummy"); var_dump($ref->getAttributes("See")[0]->getName()); var_dump($ref->getAttributes("See")[0]->getArguments());
會(huì)輸出:
string(3) "See" array(1) { [0]=> string(30) "https://xxxxxxxx/xxxx/xxx.html" }
當(dāng)然,還有稍微高級(jí)一點(diǎn)的用法,就是你可以定義一個(gè)所謂的 “注解類”:
> class MyAttribute { public function __construct($name, $value) { var_dump($name); var_dumP($value); } }
然后, 你就可以寫(xiě)類似, 注意其中的 newInstance 調(diào)用:
<> function dummy($argument) { } $ref = new ReflectionFunction("dummy"); $ref->getAttributes("MyAttribute")[0]->newInstance();
如果你跑這段代碼,你會(huì)看到 MyAttribute 的__construct 方法被調(diào)用了,調(diào)用傳遞的參數(shù)就是”See” 和”https://xxx”
明白了么, 就是你可以把一個(gè)注解 “實(shí)例化”, 然后,你就可以基于這個(gè)能力,來(lái)做自己的 “注釋即配置” 的設(shè)計(jì)。總結(jié)下 Attributes 的寫(xiě)法就是如下的形式:
<> < > < > < >
然后你就可以通過(guò) PHP 的 Reflection 系列的方法,根據(jù) getAttributes (“Name”) 獲取對(duì)應(yīng)的注解, 進(jìn)一步你可以通過(guò)調(diào)用返回的注解的 getName 方法獲取名字,getArguments 方法獲取括號(hào)中的 Arguments。
再進(jìn)一步,如果 Name 是一個(gè)你自己定義的,帶有 phpAttriubtes 注解的類, 你還可以調(diào)用 newInstance 方法,實(shí)現(xiàn)類似”new Name (Arguments)” 的調(diào)用。
也許很多人會(huì)問(wèn),這有什么卵用?
坦白說(shuō),我一直對(duì)新特性無(wú)感,但這個(gè) Attributes,多少還是應(yīng)該有那么一點(diǎn)點(diǎn)吧。
推薦文章:《PHP8.0》