百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT技术 > 正文

PHP 8新特性之Attributes(注解),你掌握了吗?

wptr33 2025-06-28 17:14 9 浏览

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呢,其实就是把“注释”升级为支持格式化内容的“注解”

比如上面的例子:

    <<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

领取方式:点赞关注小编后私信【资料】获取资料领取方式!

部分资料展示:

领取方式:点赞关注小编后私信【资料】获取资料领取方式!

相关推荐

「网络安全」JAVA代码审计——XXE外部实体注入

一、WEB安全部分想要了解XXE,在那之前需要了解XML的相关基础二、XML基础...

Web前端面试题目及答案汇总(web前端面试题最新)

Web前端面试题目及答案汇总来源:极客头条以下是收集一些面试中经常会遇到的经典面试题以及自己面试过程中无法解决的问题,通过对知识的整理以及经验的总结,重新巩固自身的前端基础知识,如有错误或更好的答案,...

什么是脚本文件?与可执行文件有什么不同?

今天的内容是脚本文件和可执行文件是两种不同类型的计算机文件,它们在结构和执行方式上有显著区别。脚本文件:定义与特性...

20个实用Python运维脚本(收藏级)(python 运维工具)

系统环境:支持Linux(Ubuntu/CentOS/Debian)和Windows...

2026年前每个开发者都应该学习的技能

优秀开发者...

Linux 如何每 5、10、15 或 30 分钟运行一次 Cron 作业?

在Linux系统中,Cron是一个强大的工具,用于自动化重复性任务。通过合理配置...

Shell脚本编程进阶实战:从入门到高效自动化

Shell脚本编程进阶实战:从入门到高效自动化一、参数处理进阶:打造专业级CLI工具1.高级参数解析示例...

在Bash中按分隔符拆分字符串的方法

技术背景在Bash脚本编程中,经常会遇到需要按特定分隔符拆分字符串的需求,例如处理CSV文件、解析日志等。掌握字符串拆分的方法对于数据处理和脚本自动化非常重要。...

程序员用5分钟,把一个400多MB的苹果安装包削掉了187MB

丰色发自凹非寺量子位|公众号QbitAI前些日子,一个...

如何在 Windows 上编写批处理脚本

你知道如何使用命令提示符吗?如果这样做,您可以编写一个批处理文件。在最简单的形式中,批处理文件(或批处理脚本)是双击文件时执行的几个命令的列表。批处理文件一直回到DOS,但仍然适用于现代版本的Win...

一文搞懂shell脚本(shell脚本应用实战)

一文搞懂shell脚本1、shell脚本介绍什么是shell脚本...

一文讲清ShellScript脚本编程知识

摘要:本文详尽地讲述了ShellScript的基础内容,还有它在Linux系统里的运用情况,涵盖了它的基本语法、常用的命令以及高级的功能。ShellScript可是一种简单又非常实用的编...

在Bash脚本中获取自身所在目录的方法

技术背景在使用Bash脚本时,有时需要获取脚本自身所在的目录。比如,当脚本作为另一个应用程序的启动器时,需要将工作目录更改为脚本所在的目录,以便对该目录中的文件进行操作。然而,由于脚本的调用方式多样(...

shell中如何确定脚本的位置?这篇文章告诉你

我想从同一个位置读取一些配置文件,如何确定脚本的位置?。这个问题的出现主要是由两个原因引发的:一是您希望将脚本的数据或配置进行外部化,因此需要一种方式来寻找这些外部资源;二是您的脚本需要对某些捆绑资源...

bash shell 语法(bash命令用法)

下面是**Shell(Bash)语法的常用知识点总结**,适合初学者和日常脚本编写参考。内容涵盖变量、判断、循环、函数、重定向、正则、数组等常见用法。---#Shell(Bash)语法速查总结...