聊聊 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的資料請關注億速云其它相關文章！