Xaop 功能特色 介绍
Xaop —— PHP高性能的AOP扩展
功能特色
-
文档注解AOP模式
-
方法注入AOP模式
; To enable the AOP mode ; 1 不启用AOP ; 2 文档注解AOP模式 ; 3 方法注入AOP模式 xaop.aop_mode = 3
<?php /** *@Aspect */ class Swing { public function _before() { echo '_before'; } /** *@before(value="Xaop._before") */ public function goodLists() { echo 'goodLists'; } }
因为基于 ZendOPcode ,所以不需要使用代理对象完成切面, 直接调用方法 即可:
<?php $swig = new Swing(); $swig->goodLists(); // 输出如下: _before goodLists
文档注解支持 自定义注解 与扩展 内置注解 :
- 自定义注解
自定义注解必须继承自 Xaop\Annotation 接口,并且实现 input 方法即可,如下示例自定义了一个 @Tag 注解:
namespace app; use Xaop\Annotation; class Tag implements Annotation { function input($object, $annotations) { var_dump($object); foreach($annotations as $key => $val) { echo $key . '=' . $val . PHP_EOL; } } }
使用的时候只需要传入全名即可:
<?php /** * @Aspect */ class Swing { /** * @app\Tag( money = 5000, user = "Xaop" ) */ public function getMoney() { } }
- 内置注解
内置强大的六个专用注解: @api 、 @disable 、 @before 、 @after 、 @success
、 @failure
- @api
开发 API 推荐使用,使用本注解,直接可以向客户端返回 JSON 或者 XML
数据,只需要在修饰的方法体返回数据数据即可,注解包含两个参数:
type 与 charset , 如下使用:
/** *@api(type=JSON, charset=UTF-8) */ public function newLists() { return [ ['12' => {xxx,xxx}], ['23'=>{xxx,xxx}] ]; }
或者
/** *@api(type=xml, charset=UTF-8) */ public function newLists() { return [ ['12' => {xxx,xxx}], ['23'=>{xxx,xxx}] ]; }
注意:参数名区分大小写,参数值不区分大小写。
- @disable
使用本注解可以禁用类的方法,使用本注解修饰的方法,就不会调用,并且不会提示任何错误信息,直接返回,本注解不包含任何参数。
- @before
前置通知,在方法之前执行本注解包含的方法:如:
@before(value="app\models\User.startTransaction")
在执行之前开启事务支持
- @after
后置通知,在方法之后执行本注解包含的方法:如:
@after(value="app\log\InvokeLog.record")
在接口调用之后进行日志记录
- @success
方法体返回 true 的时候调用的通知:如:
@success(value="app\models\User.commit")
在方法执行成功之后提交事务
- @failure
方法体返回 false 之后调用的通知,如下:
@failure(value="app\models\User.rollback")
在方法体返回失败的时候回滚事务
仅支持 前置注入 与 后置注入 模式,环绕模式正在开发:
<?php class Swing { public function _before() { echo '_before'; } public function getLists() { echo 'getLists'; } } // 在所有的 Swing类中,以 getLists开头的方法调用的时候都会调用 Swing类的 _before 方法 \Xaop::addBeforeAop(Swing::class, "getLists*", [ Swing::class, '_before' ]); // 后置注入 // \Xaop::addAfterAop(Swing::class, "getLists*", [ Swing::class, '_after' ]);
调用即可:
$swing = new Swing(); $swing->getLists(); // 输出如下: _before getLists
Xaop APIs
前置注入:addBeforeAop
public function addBeforeAop ($className, $funtionName, $callback = [ ])
后置注入:addAfterAop
public function addAfterAop ($className, $funtionName, $callback = [ ])
注意:
$className与$functionName支持模糊匹配模式,使用 * 代替任意字符,并且只能存在一个 * 符号,存在多个 * 符号会报错,如下示例:
<?php namespace app; class Swing { public function _before() { echo 'before'; } public function views() { echo 'views'; } } // 给 Swing 类的 views 方法增加前置注入 \Xaop::addBeforeAop(Swing::class, 'views', [ Swing::class, '_before' ] ); // 给 Swing 类中,以 v 开头的方法增加前置注入 \Xaop::addBeforeAop(Swing::class, 'v*', [ Swing::class, '_before' ]); // 给以 app 开头的命名空间并且方法以 v 开头的增加前置注入 \Xaop::addBeforeAop("app*", 'v*', [ Swing::class, '_before' ]);
[警告⚠️]:如果 $functionName 仅仅存在 字符 *, 此时系统会直接终止,由于 *
匹配任何方法,当你匹配方法的时候,如果仅仅使用 * 去匹配任何方法,那么会造成 闭合调用 ( 调用本方法之前都调用本方法
),造成PHP内核终止。之所以保留单个 * 字符,是因为 $className 可以使用 单个 * 去匹配任何类或者命名空间。
Xaop 功能特色 官网
https://github.com/liqiongfan/xaop
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。