php单个字段的注释-php的注释可以是

admin

作者

PHP8php单个字段的注释的Alpha版本php单个字段的注释，过几天就要发布了，其中包含了不少的新特性，当然php单个字段的注释我自己认为最重要的还是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呢，其实就是把“注释”升级为支持格式化内容的“注解”

比如上面的例子：

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

从PHP8 Alpha2开始，你也可以写成:

<< 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)>> <<Name1(Argument), Name2(Argument), Name3(Argument)>>

然后你就可以通过PHP的Reflection系列的 *** ，根据getAttributes("Name")获取对应的注解，进一步你可以通过调用返回的注解的getName *** 获取名字，getArguments *** 获取括号中的Arguments。

再进一步，如果Name是一个你自己定义的, 带有phpAttriubtes注解的类，你还可以调用newInstance *** ，实现类似"new Name(Arguments)"的调用。

也许很多人会问，这有什么卵用？

坦白说，我一直对新特性无感，但这个Attributes，多少还是应该有那么一点点吧

然而在这里可能有PHPer说用Go不香吗？要想成为一个优秀的开发者，你应该关注解决问题层面上来，用现有的技术资源去成就商业，而不是用公司的资源去成就一门技术，为了技术而技术！如果你不能用一种语言里面的基本特性写出好的代码解决问题，那你换成另外一种语言也无济于事。技术人员的发展一直都是“T”字型，如果连吃饭的PHP都学不好，转Java、GO语言你就能成为大牛了？

而PHP学到极致就不仅限于PHP的使用，势必涉及到性能优化，算法、Swoole、微服务、分布式高并发、Linux、Kafka、MQ等不一而足；先精一门，为全面且不肤浅打基础。为了大家能够顺利进阶架构师，我特地准备了一套精品PHP架构师教程，助你薪资突破30K。