## 概述
行为(Behavior)是ThinkPHP扩展机制中比较关键的一项扩展,行为既可以独立调用,也可以绑定到某个标签中进行侦听,在官方提出的CBD模式中行为也占了主要的地位,可见行为在ThinkPHP框架中意义非凡。
这里指的行为是一个比较抽象的概念,你可以把行为想象成在应用执行过程中的一个动作或者处理。在框架的执行流程中,例如路由检测是一个行为,静态缓存是一个行为,用户权限检测也是行为,大到业务逻辑,小到浏览器检测、多语言检测等等都可以当做是一个行为,甚至说你希望给你的网站用户的第一次访问弹出Hello,world!这些都可以看成是一种行为,行为的存在让你无需改动框架和应用,而在外围通过扩展或者配置来改变或者增加一些功能。
而不同的行为之间也具有位置共同性,比如,有些行为的作用位置都是在应用执行前,有些行为都是在模板输出之后,我们把这些行为发生作用的位置称之为标签(位),当应用程序运行到这个标签的时候,就会被拦截下来,统一执行相关的行为,类似于AOP编程中的“切面”的概念,给某一个切面绑定相关行为就成了一种类AOP编程的思想。
ThinkPHP5.0增加了一个行为的总开关常量,要使用行为必须先开启,如下:
~~~
define('APP_HOOK',true);
~~~
## 行为标签位
在定义行为之前,我们先来了解下系统有哪些标签位,系统核心提供的标签位置包括下面几个(按照执行顺序排列):
|||
|---|---|
|app_init |应用初始化标签位|
|path_info |PATH_INFO检测标签位|
|app_begin |应用开始标签位|
|action_begin| 控制器开始标签位|
|view_begin |视图输出开始标签位|
|view_filter| 视图输出过滤标签位|
|action_end |控制器结束标签位|
|app_end |应用结束标签位|
|error_output|异常信息输出标签(仅对非html输出类型有效)|
在每个标签位置,可以配置多个行为定义,行为的执行顺序按照定义的顺序依次执行。除非前面的行为里面中断执行了(某些行为可能需要中断执行,例如检测机器人或者非法执行行为),否则会继续下一个行为的执行。
> 除了这些系统内置标签之外,开发人员还可以在应用中添加自己的应用标签。
## 添加行为标签位
可以使用Think\Hook类的listen方法添加自己的行为侦听位置,例如:
~~~
\think\Hook::listen('action_init');
~~~
可以给侦听方法传入参数(仅能传入一个参数),该参数使用引用传值,因此必须使用变量,例如:
~~~
\think\Hook::listen('action_init',$params);
~~~
侦听的标签位置可以随意放置。
## 行为定义
行为类的定义很简单,定义行为的执行入口方法run即可,例如:
~~~
namespace app\index\behavior;
class Test {
public function run(&$params){
// 行为逻辑
}
}
~~~
行为类并不需要继承任何类,相对比较灵活。
如果行为类需要绑定到多个标签,可以采用如下定义:
~~~
namespace app\index\behavior;
class Test {
public function app_init(&$params){
}
public function app_end(&$params){
}
}
~~~
绑定到`app_init`和`app_end`后 就会调用相关的方法。
## 行为绑定
行为定义完成后,就需要绑定到某个标签位置才能生效,否则是不会执行的。
使用Hook类的add方法注册行为,例如:
~~~
\think\Hook::add('app_init','behavior\\CheckLang'); // 注册 behavior\CheckLang行为类到app_init标签位
\think\Hook::add('app_init','admin\\behavior\\CronRun');//注册 admin\behavior\CronRun行为类到app_init标签位
~~~
如果要批量注册行为的话,可以使用:
~~~
\think\Hook::add('app_init',['behavior\\CheckAuth','behavior\\CheckLang','admin\\behavior\\CronRun']);
~~~
当应用运行到`app_init`标签位的时候,就会依次调用`behavior\CheckAuth`、`behavior\CheckLang`和`admin\behavior\CronRun`行为。如果其中一个行为中有中止代码的话则后续不会执行,如果返回`false`则当前标签位的后续行为将不会执行,但应用将继续运行。
我们也可以直接在APP_PATH目录下面或者模块的目录下面定义`tags.php`文件来统一定义行为,定义格式如下:
~~~
return [
'app_init'=> [
'behavior\\CheckAuth',
'behavior\\CheckLang'
],
'app_end'=> [
'admin\\behavior\\CronRun'
]
]
~~~
如果APP_PATH目录下面和模块目录下面的tags.php都定义了app_init的行为绑定的话,会采用合并模式,如果希望覆盖,那么可以在模块目录下面的tags.php中定义如下:
~~~
return [
'app_init'=> [
'behavior\\CheckAuth',
'_overlay'=>true
],
'app_end'=> [
'admin\\behavior\\CronRun'
]
];
~~~
如果某个行为标签定义了`'_overlay' =>true` 就表示覆盖之前的相同标签下面的行为定义。
## 闭包支持
可以不用定义行为直接把闭包函数绑定到某个标签位,例如:
~~~
\think\Hook::add('app_init',function(){ echo 'Hello,world!';});
~~~
如果标签位有传入参数的话,闭包也可以支持传入参数,例如:
~~~
\think\Hook::listen('action_init',$params);
\think\Hook::add('action_init',function($params){ var_dump($params);});
~~~
## 直接执行行为
如果需要,你也可以不绑定行为标签,直接调用某个行为,使用:
~~~
// 执行 behavior\CheckAuth行为类的run方法 并引用传入params参数
$result = \think\Hook::exec('behavior\\CheckAuth','run',$params);
~~~