PHP8 新特性之 Attributes

2020-07-16 10:06:15

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,多少還是應該有那麼一點點吧

以上就是PHP8 新特性之 Attributes的詳細內容,更多請關注TW511.COM其它相關文章!