PHP8 新功能之 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 》

以上是PHP8 新功能之 Attributes的詳細內容。更多資訊請關注PHP中文網其他相關文章！