PHP8中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)"的调用。

关于PHP8中Attributes的介绍就分享到这里了，希望以上内容可以对大家有一定的帮助，可以学到更多知识。如果觉得文章不错，可以把它分享出去让更多的人看到。