HyperfAOP与切面编程实战解析

本文深入讲解了 Hyperf 框架中 AOP（面向切面编程）的完整落地实践，从启用 AOP 支持、定义自定义注解、编写符合 AspectInterface 的切面类，到通过 execution 表达式或注解精准拦截方法调用，手把手演示如何在不侵入业务代码的前提下，统一实现日志记录、执行耗时监控等横切关注点——让开发者轻松掌握高内聚、低耦合的现代 PHP 工程化技巧。

Hyperf 中的 AOP（面向切面编程）主要通过注解 + 切面类 + 注入容器的方式实现，核心是拦截方法调用，在不修改业务代码的前提下统一处理日志、权限、事务、监控等横切关注点。

一、启用 AOP 支持

Hyperf 默认未开启 AOP，需手动启用：

• 在 config/autoload/annotations.php 中确保扫描路径包含你的切面类和被拦截的控制器/服务类；
• 确认 config/autoload/dependencies.php 已注册 Hyperf\Aop\AspectContainer；
• 启动时需加载 AOP 组件：确保 hyperf/aop 已安装，并在 composer.json 的 require 中存在。

二、定义自定义注解

切面行为通常由注解触发。例如定义一个 @LogExecutionTime：

• 新建注解类 App\Annotation\LogExecutionTime，继承 Hyperf\Di\Annotation\AbstractAnnotation；
• 加上 @Target({Target::CLASS, Target::METHOD}) 表明可作用于类或方法；
• 注解本身不执行逻辑，只作为标记，供切面类识别。

三、编写切面类

切面类需实现 Hyperf\Aop\Contract\AspectInterface，并指定拦截规则：

• getRules() 返回匹配表达式，如 "execution(* App\Controller\*.*)" 或结合注解："@annotation(App\Annotation\LogExecutionTime)"；
• process(ProceedingJoinPoint $proceedingJoinPoint) 是核心逻辑：可记录开始时间 → 执行原方法 → 记录耗时 → 写入日志；
• 务必调用 $proceedingJoinPoint->process() 否则目标方法不会执行。

四、使用示例（打日志+计时）

在控制器方法上加注解：

配合对应切面类，每次调用 index 就会自动输出执行耗时，无需侵入业务代码。

到这里，我们也就讲完了《HyperfAOP与切面编程实战解析》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于Hyperf的知识点！