聊聊 PHP 8 新特性 Attributes

PHP8的Alpha版本，過(guò)幾天就要發(fā)布了，其中包含了不少的新特性，當(dāng)然我自己認(rèn)為最重要的還是JIT，這個(gè)我從2013年開(kāi)始參與，中間挫折無(wú)數(shù)，失敗無(wú)數(shù)后，終于要發(fā)布的東東。

不過(guò)，今天呢，我不打算談JIT，等PHP8發(fā)布了以后，我再單獨(dú)寫個(gè)類似《深入理解PHP8之JIT》系列來(lái)說(shuō)吧。

嘿嘿，今天呢，我想談?wù)凙ttributes，為啥呢， 是昨天我看到很多群在轉(zhuǎn)發(fā)一個(gè)文章，叫做《理解PHP8中的Attributes》，說(shuō)實(shí)在的，這篇文章應(yīng)該是直接從英文翻譯過(guò)來(lái)的，寫的晦澀難懂，很多同學(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)容的 “注解”

比如上面的例子：

<?php
<<Params("Foo", "argument")>>
<<See("https://xxxxxxxx/xxxx/xxx.html")>>
function dummy($argument) {}

大家不要糾結(jié)這么寫的意義是啥，從功能上來(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è)所謂的“注解類”:

<?php
<<phpAttribute>>
class MyAttribute {
  public function __construct($name, $value) {
   var_dump($name);
   var_dumP($value);
  }
}

然后， 你就可以寫類似， 注意其中的newInstance調(diào)用：

<<MyAttribute("See", "https://xxxxxxxx/xxxx/xxx.html")>>
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的寫法就是如下的形式:

<<Name>>
<<Name(Arguments)>>
<<Name(Argunment1, Arguments2, ArgumentN)>>

然后你就可以通過(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)吧 ????

以上就是聊聊 PHP 8 新特性 Attributes的詳細(xì)內(nèi)容，更多關(guān)于PHP 8 Attributes的資料請(qǐng)關(guān)注億速云其它相關(guān)文章！