带你学习hyperf-3.9 AOP 面向切面编程

3.9 AOP 面向切面编程

概念

AOP 为 Aspect Oriented Programming 的缩写，意为：面向切面编程，通过动态代理等技术实现程序功能的统一维护的一种技术。AOP 是 OOP 的延续，也是 Hyperf 中的一个重要内容，是函数式编程的一种衍生范型。利用 AOP 可以对业务逻辑的各个部分进行隔离，从而使得业务逻辑各部分之间的耦合度降低，提高程序的可重用性，同时提高了开发的效率。

用通俗的话来讲，就是在 Hyperf 里可以通过 切面(Aspect) 介入到任意类的任意方法的执行流程中去，从而改变或加强原方法的功能，这就是 AOP。

注意这里所指的任意类并不是完全意义上的所有类，在 Hyperf 启动初期用于实现 AOP 功能的类自身不能被切入。

介绍

相对于其它框架实现的 AOP 功能的使用方式，我们进一步简化了该功能的使用不做过细的划分，仅存在 环绕(Around) 一种通用的形式：

• 切面(Aspect) 为对流程织入的定义类，包括要介入的目标，以及实现对原方法的修改加强处理
• 代理类(ProxyClass) ，每个被介入的目标类最终都会生成一个代理类，来达到执行 切面(Aspect) 方法的目的

定义切面(Aspect)

每个 切面(Aspect) 必须实现 HyperfDiAopAroundInterface 接口，并提供 public 的 $classes 和 $annotations 属性，为了方便使用，我们可以通过继承 HyperfDiAopAbstractAspect 来简化定义过程，我们通过代码来描述一下。

<?php
namespace AppAspect;

use AppServiceSomeClass;
use AppAnnotationSomeAnnotation;
use HyperfDiAnnotationAspect;
use HyperfDiAopAbstractAspect;
use HyperfDiAopProceedingJoinPoint;

/**
 * @Aspect
 */
class FooAspect extends AbstractAspect
{
    // 要切入的类或 Trait，可以多个，亦可通过 :: 标识到具体的某个方法，通过 * 可以模糊匹配
    public $classes = [
        SomeClass::class,
        'AppServiceSomeClass::someMethod',
        'AppServiceSomeClass::*Method',
    ];

    // 要切入的注解，具体切入的还是使用了这些注解的类，仅可切入类注解和类方法注解
    public $annotations = [
        SomeAnnotation::class,
    ];

    public function process(ProceedingJoinPoint $proceedingJoinPoint)
    {
        // 切面切入后，执行对应的方法会由此来负责
        // $proceedingJoinPoint 为连接点，通过该类的 process() 方法调用原方法并获得结果
        // 在调用前进行某些处理
        $result = $proceedingJoinPoint->process();
        // 在调用后进行某些处理
        return $result;
    }
}

每个 切面(Aspect) 必须定义 code>@Aspect 注解或在 config/autoload/aspects.php 内配置均可发挥作用。

您也可以通过 code>@Aspect 注解本身的属性来完成切入目标的配置，通过下面注解的形式可以达到与上面的示例一样的目的：

<?php
namespace AppAspect;

use AppServiceSomeClass;
use AppAnnotationSomeAnnotation;
use HyperfDiAnnotationAspect;
use HyperfDiAopAbstractAspect;
use HyperfDiAopProceedingJoinPoint;

/**
 * @Aspect(
 *   classes={
 *      SomeClass::class,
 *      "AppServiceSomeClass::someMethod",
 *      "AppServiceSomeClass::*Method"
 *   },
 *   annotations={
 *      SomeAnnotation::class
 *   }
 * )
 */
class FooAspect extends AbstractAspect
{
    public function process(ProceedingJoinPoint $proceedingJoinPoint)
    {
        // 切面切入后，执行对应的方法会由此来负责
        // $proceedingJoinPoint 为连接点，通过该类的 process() 方法调用原方法并获得结果
        // 在调用前进行某些处理
        $result = $proceedingJoinPoint->process();
        // 在调用后进行某些处理
        return $result;
    }
}