cr0/interceptor-php

简单的具有依赖注入容器的AOP拦截器。

1.0 2024-05-05 01:44 UTC

This package is auto-updated.

Last update: 2024-09-06 23:57:07 UTC


README

介绍

Interceptor PHP是一个PHP库,它为类的实例提供了一个依赖注入容器,并具有拦截PHP对象的功能。基于AOP(面向方面编程)的原则,允许在类中原有方法之前、之后或代替原有方法执行方法。

安装

您可以通过Composer安装Interceptor PHP。在终端中运行以下命令

composer require cr0/interceptor-php

基本用法

以下是一个如何使用库的基本示例

use Interceptor\Kernel; 
use SeuNamespace\Customer; 
use SeuNamespace\AspectExample;  
// Obtenha uma instância do Kernel 
$kernel = Kernel::getInstance();  
// Adicione um proxy para a classe Customer e seu aspecto 
$kernel->addProxy(Customer::class, AspectExample::class);  
// Construa o contêiner de injeção de dependência 
$container = $kernel->build();  
// Obtenha uma instância da classe Customer do contêiner 
$customer = $container->get(Customer::class);  
// Chame um método da classe Customer 
echo $customer->getName('Bruno');

方面示例

以下是一个如何定义方面以拦截Customer类方法的示例

use SeuNamespace\Customer;  
class AspectExample {     
    public function beforeGetName(Customer $subject, string $name){ 
        echo "Calling before GetName Method";            
        // Executa antes do método getName() e retorna um array com parametros      alterados        
        return [             "Nome substituido"         
        ];     
    }      
    public function aroundGetName(Customer $subject, string $name) : string     {  
        echo "Calling around GetName Method";       
        // Substitui o método getName() e retorna um valor personalizado         
        return "Teste 123";     
    }      
    public function afterGetName(Customer $subject, $out)     { 
        echo "Calling after GetName Method";            
        // Executa após o método getName()         
        echo $out;         
        return $out;     
    } 
}

可用方法

  • beforeMethodName(ObjetoClasse $objeto, ...$args):在methodName()方法之前执行。
  • aroundMethodName(ObjetoClasse $objeto, ...$args):替换methodName()方法,可以返回一个自定义值。
  • afterMethodName(ObjetoClasse $objeto, $retorno):在methodName()方法之后执行。

总结

Interceptor PHP库提供了一种优雅的方式,可以在类的方法中添加额外的逻辑,遵循AOP原则。这有助于分离关注点,并在代码的多个部分重用方面。尝试一下,看看它如何改善您的PHP应用程序结构。