Press "Enter" to skip to content

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,多少还是应该有那么一点点吧 🙂

29 Comments

  1. Denver Pearce
    Denver Pearce July 10, 2020

    PHP, there are only two ways to live your life. One is as though nothing is a miracle.

  2. wj008
    wj008 July 5, 2020

    <>
    function dummy($argument) {

    }
    这样 不应该报错才对啊。。。

    • wj008
      wj008 July 5, 2020


      Params(“Foo”, “argument”)
      See(“https://xxxxxxxx/xxxx/xxx.html”)
      Field(1)

      function dummy($argument) {

      }
      这样 不应该报错才对啊。。。

  3. Tony
    Tony July 2, 2020

    类似于C#、JAVA、Golang等的特性

  4. Bourne
    Bourne July 2, 2020

    确实丑,而且注解不利于代码阅读和调试

  5. sleep
    sleep June 27, 2020

    我觉得挺好的,没有必要吐槽符号如何如何, 如果想用着自己舒服可以成为改变这个语言的人,而不是在这里吐槽别人辛辛苦苦的设计成果.

  6. jam
    jam June 27, 2020

    大家都已习惯了注释,突然弄出一个这东西,看的我一脸懵逼,没懂,还觉得我以后还是会使用注释不会使用这个特性

  7. Alim
    Alim June 26, 2020

    我个人没感觉到太大的用途、

    • Alim
      Alim June 26, 2020

      个人感觉原来的备注挺好的

  8. church
    church June 22, 2020

    就因为”@”已经被用作抑制错误,就弄了个这么ugly的语法,真不如没有。不知道鸟哥介绍的是不是这个所谓“注解的”全部了,如果是这样的话,也太拙劣了,聊胜于无的东西。

  9. boobusy
    boobusy June 19, 2020

    真没什么卵用.太丑了, 可以在@符号做点文章. !@ 代表注解

  10. lianjiexue
    lianjiexue June 17, 2020

    太丑了,php明显跑偏

  11. Bo
    Bo June 16, 2020

    通俗易懂 就是这个写法有点尬,咋一看 以为是写的注释的,看着不太像注解

  12. 正
    June 15, 2020

    哈哈,写法确实有点丑啊

  13. ctfang
    ctfang June 15, 2020

    不用php自带也能实现相同的功能,只是更加方便了,特别对具有console命令的应用,例如数据库到模型类文件可以互相严格定义。

    什么时候可以解决一下:
    1,官方维护支持线程
    虽然线程扩展一直都用,但是都处于很尴尬的位置,停止维护,也没有人敢用。

    2,内存共享+强类型的map
    现有的扩展apc, shmop等,文件流共享,意义不大。
    比如常见web电商需求,提取评价的关键字,加载字典后,再转成树结构都要300MB内存左右,大点就算了,还无法共享使用。

    3,php-src自带的协程。
    swoole就实现了协程,至少证明技术上是可行的,但是swoole社区不稳定,知名公司,开源框架都和swoole闹翻了(有赞,SwooleDistributed,swoft,easyswoole等);

    • 李尔摩斯
      李尔摩斯 June 29, 2020

      同意!不然,感觉PHP前途渺茫,在性能要求很高的项目中直接被GO给干翻了

    • wj008
      wj008 July 3, 2020

      我觉得 php 引入协程 会对目前现有的基于php-fpm的发起一大挑战,协程一般是在常驻内存应用才能起到作用,而 php 的生态对常驻内存并不那么友好,而且 phper 不像javaer 一样 具备常驻内存开发的习惯和基础(phper 大多数没有释放内存习惯和变量会被污染的处理能力),这对于php环境来讲是一个灾难性的。
      除非有一天 vm 可以和java 或者 nodejs 一样 是常驻内存型的。但这个应该就是swoole 要做的工作,事实上两者是冲突的。很多人会在常驻内存环境中使用到非常驻内存的代码而造成系统不稳定,这样 swoole 就得背这个锅了。
      所以 如果说要开发协程 我觉得 应该是要从语法上重新定义一种语言,也就是完全放弃现有的 php 非常驻内存的生态,才有可能,比如 nodejs.

  14. zhouyl
    zhouyl June 15, 2020

    为何不像java一样,使用 @Name @Name(Arguments) 这种格式,感觉更美观,并且编码过程中少敲不少字符

    • 魔王卷子
      魔王卷子 June 15, 2020

      因为有个抑制运算符已经将@使用了。所以不能用那个了。

  15. nece001
    nece001 June 15, 2020

    注解终于要来了吗?

  16. Hawind
    Hawind June 13, 2020

    丑死了,发展了25年,什么都学JAVA的,空间用\就忍了,这个尼马要是写多了哪里还分的出正常代码还是注解,然后就是啥新特性,卧槽jdk5就有注解了,那么多《》《》《》好吗,至少让大家少打点符号,看着这个真心气炸了,诅咒决定用这个符号的人***。

    • laruence
      laruence June 13, 2020

      你的心情我可以理解,但可以适当淡定, IDE后续也会跟进修改,结合适当的配色,回降低对阅读正常代码影响的。

  17. ideaa
    ideaa June 12, 2020

    对我来说很有用,但是这语法简直丑出天际

    • SJ Chou
      SJ Chou June 15, 2020

      對於 Framework 的設計到是很有用,特別是 IoC/DI 這樣的架構,但是看到語法就有點想吐,想說 PHP8 為何不強化 getDocComment() 即可!?
      期待鳥哥下一篇 JIT 文章~多謝分享~

      • dvaknheo
        dvaknheo June 16, 2020

        现在大部分 PHP 的 IoC/DI 走偏了,没用上 PHP 的动态语言特性。
        为了解决 “调用方式不变,实现方式可变”这一问题,我的解决方案是使用可变单例。
        我写的框架 DuckPhp 有类似的用法
        MyClass::G()->foo(); // 输出 hello world
        MyClass::G(MySubClass::G()); //替换实例
        MyClass::G()->foo(); // 输出 你好。

        前后者调用方式都一样,实际上 第二句把 MyClass 的单例替换了。 导致后面输出为 MySubClass->foo()
        这个 ::G()-> 我也想替换成其他更简洁的方法,实在是替换不了了

  18. vic
    vic June 12, 2020

    也许很多人会问,这有什么卵用?

  19. mr
    mr June 12, 2020

    get新特性

  20. Grocker
    Grocker June 12, 2020

    提前get到了

Leave a Reply

Your email address will not be published. Required fields are marked *