README

Go! AOP 是一个使用纯 PHP 开发的现代化面向切面编程框架，具有丰富的功能，适用于新级别的软件开发。该框架通过为现有代码提供高效且透明的钩子系统，允许通过传统面向对象 PHP 代码解决交叉问题。

特性

为 PHP 提供动态钩子系统，无需修改原始源代码。
无需任何 PECL 扩展（php-aop、runkit、uopz）和 DI 容器即可运行。
方面、连接点和切入点采用面向对象设计。
拦截类中任何公开或受保护的公共或保护方法执行。
拦截静态方法和最终类中的方法执行。
拦截 traits 中的方法执行。
拦截对象对公共/受保护属性的访问。
为静态类初始化提供钩子（在类被加载到 PHP 内存后）。
为对象初始化提供钩子（拦截 new 关键字）。
拦截系统 PHP 函数调用。
通过 Around 类型的建议，能够更改任何方法/函数的返回值。
丰富的切入点语法，用于在源代码中定义切入点。
使用 XDebug 对 AOP 进行本地调试。带有织入方面的代码是完全可读的和本地的。您可以在原始类或方面中设置断点，并且它将工作（用于调试模式）！
可以与任何现有的 PHP 框架和库（带或不带额外配置）集成。
高度优化以用于生产：支持 opcode 缓存、建议和方面的懒加载、连接点缓存、无需运行时检查切入点、无需运行时解析注释、无需 evals 和 __call 方法、无需缓慢的代理和 call_user_func_array()。快速的引导过程（2-20ms）和建议调用。

AOP 是什么？

AOP (面向切面编程) 是一种处理交叉问题的方法，其中这些问题以“模块化”的方式（即，适当的封装、缺乏重复等）设计和实现，然后通过声明性或程序性手段以简洁和可靠的方式集成到所有相关的执行点。

在 AOP 术语中，执行点称为连接点。这些点的集合称为切入点，而执行在连接点之前、之后或“周围”的新行为称为建议。您可以在简介部分中了解更多关于 AOP 的信息。

安装

Go! AOP 框架可以使用 composer 安装。安装非常简单

使用 composer 下载框架
创建应用程序方面内核
在前端控制器中配置方面内核
创建方面
在方面内核中注册方面

步骤 0（可选）：尝试框架中的示例

让 composer 在空目录中创建新项目

composer create-project goaop/framework

之后，只需配置您的 Web 服务器以 demos/ 文件夹，然后在浏览器中打开它。然后您可以在深入了解将其安装到您的项目中之前查看一些示例。

步骤 1：使用 composer 下载库

通过运行命令让Composer下载Go! AOP框架及其依赖的最新版本

composer require goaop/framework

Composer会将框架安装到您项目的vendor/goaop/framework目录中。

步骤2：创建应用方面内核

该框架的目标是为您的应用提供易于集成的AOP。您必须首先为应用创建一个AspectKernel类。这个类将统一管理应用的所有方面。

框架提供了一个基类，使创建自己的内核更加容易。为了创建应用内核，扩展抽象类Go\Core\AspectKernel

<?php
// app/ApplicationAspectKernel.php

use Go\Core\AspectKernel;
use Go\Core\AspectContainer;

/**
 * Application Aspect Kernel
 */
class ApplicationAspectKernel extends AspectKernel
{

    /**
     * Configure an AspectContainer with advisors, aspects and pointcuts
     *
     * @param AspectContainer $container
     *
     * @return void
     */
    protected function configureAop(AspectContainer $container)
    {
    }
}

3. 在前端控制器中配置方面内核

要配置方面内核，请调用内核实例的init()方法。

// front-controller, for Symfony2 application it's web/app_dev.php

include __DIR__ . '/vendor/autoload.php'; // use composer

// Initialize an application aspect container
$applicationAspectKernel = ApplicationAspectKernel::getInstance();
$applicationAspectKernel->init([
        'debug'        => true, // use 'false' for production mode
        'appDir'       => __DIR__ . '/..', // Application root directory
        'cacheDir'     => __DIR__ . '/path/to/cache/for/aop', // Cache directory
        // Include paths restricts the directories where aspects should be applied, or empty for all source files
        'includePaths' => [
            __DIR__ . '/../src/'
        ]
]);

4. 创建方面

方面是AOP哲学中的关键元素。Go! AOP框架使用简单的PHP类来声明方面，这使得可以使用所有OOP功能来为方面类提供功能。以下是一个示例，拦截所有方法并显示它们的名称

// Aspect/MonitorAspect.php

namespace Aspect;

use Go\Aop\Aspect;
use Go\Aop\Intercept\FieldAccess;
use Go\Aop\Intercept\MethodInvocation;
use Go\Lang\Annotation\After;
use Go\Lang\Annotation\Before;
use Go\Lang\Annotation\Around;
use Go\Lang\Annotation\Pointcut;

/**
 * Monitor aspect
 */
class MonitorAspect implements Aspect
{

    /**
     * Method that will be called before real method
     *
     * @param MethodInvocation $invocation Invocation
     * @Before("execution(public Example->*(*))")
     */
    public function beforeMethodExecution(MethodInvocation $invocation)
    {
        echo 'Calling Before Interceptor for: ',
            $invocation,
            ' with arguments: ',
            json_encode($invocation->getArguments()),
            "<br>\n";
    }
}

很简单，不是吗？我们在这里声明了，我们想在类Example的所有动态公共方法执行之前安装钩子。这是通过使用注解@Before("execution(public Example->*(*))")完成的。钩子可以是任何类型，您将在稍后看到。但我们没有在类Example中改变任何代码！我现在能感觉到您的惊讶。

5. 在方面内核中注册方面

要注册方面，只需将其实例添加到内核的configureAop()方法中。

// app/ApplicationAspectKernel.php

use Aspect\MonitorAspect;

//...

    protected function configureAop(AspectContainer $container)
    {
        $container->registerAspect(new MonitorAspect());
    }

//...

6. 可选配置

6.1 自定义注解缓存

默认情况下，Go! AOP使用Doctrine\Common\Cache\FilesystemCache进行注解缓存。但是，如果您需要使用其他缓存引擎进行注解，您可以通过应用程序方面内核的annotationCache配置选项来配置缓存驱动程序。唯一的要求是缓存驱动程序实现Doctrine\Common\Cache\Cache接口。

当部署到只读文件系统时，这可能非常有用。在这种情况下，您可以使用，例如，Doctrine\Common\Cache\ArrayCache或基于内存的缓存驱动程序。

6.2 支持编织Doctrine实体（实验性，alpha版本）

由于Go! AOP为每个编织实体生成两套类，一个具体类和一个带有切入点代理，因此不能直接支持编织Doctrine实体。Doctrine会将这两个类都解释为具体实体，并为它们分配相同的元数据，这会搞乱数据库和关系（参见goaop#327）。

因此，此库提供了一个解决方案，该解决方案将解决Doctrine中的映射问题。解决方案是以事件订阅者Go\Bridge\Doctrine\MetadataLoadInterceptor的形式提供的，该订阅者必须在项目启动Doctrine时注册。有关如何操作的详细信息，请参阅http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html。

事件订阅者将修改生成的Go! Aop代理的元数据实体定义，作为映射超类。这将解决在编织Doctrine实体时可能遇到的任何问题。

7. 贡献

要贡献更改，请参阅Contribute Readme

文档

关于Go!库的文档可以在官方网站找到。如果您喜欢这个项目，可以通过来支持它。

lanfix / goaop-framework

维护者

详细信息