ThinkPHP5行为和钩子-02

绑定行为

要给钩子绑定行为有两种方式：配置绑定和动态绑定。

配置绑定

配置绑定是在应用目录或者模块目录下面的 tags.php文件中配置，app_init和app_begin钩子只
能在应用目录下面的 tags.php文件中配置模块目录下面配置无效，而其它的钩子支持应用和模块配置，
如果同时定义的话，会合并后依次执行行为。
以我们上面定义的两个行为为例，配置方式如下：
return [
'app_init'     =>   ['\app\common\behavior\Hello','\app\common\behavior\Test',],
'app_begin'    =>   ['\app\common\behavior\Test',],    
'module_init'  =>  [function($request){            
        echo 'hello,'.$request->module().'!';          
    },],  
];

假设我们的控制器类如下：
namespace app\index\controller;
class Index
{    
    public function index()      
    {        
        return 'run index
';
    }  
}

当我们访问URL
http://contoso.org

后，页面输出结果为：
hello,world! app_init testapp_begin testhello,index! run index

配置绑定的行为执行顺序就是配置的定义顺序，我们修改下配置文件里面的定义顺序如下：
return [
'app_init'     =>   ['\app\common\behavior\Test','\app\common\behavior\Hello',],
'app_begin'    =>   ['\app\common\behavior\Test',],
'module_init'  =>   [function($request){
    echo 'hello,'.$request->module().'!';
    },],
];

最终输出的结果变成：
app_init testhello,world! app_begin testhello,index! run index

如果我希望app_init钩子的Test行为执行后不再继续执行后续的行为，可以修改 Test行为类如下：
namespace app\common\behavior;
class Test
{    
    public function appInit()      
    {        
        echo 'app_init test
';
        return false;
    }    
    public function appBegin()      
    {        
        echo 'app_begin test';        
        return false;      
    }  
}

再次访问的时候，输出结果就变成了
app_init testapp_begin testhello,index! run index

我们看到，app_init钩子绑定的 Hello行为没有被执行。
现在我们在模块的tags.php文件中添加行为绑定
return [
'module_init'   => [function($request){
        echo 'welcome,'.$request->module().'!';
    },],
];

再次访问后页面输出结果为：
app_init test app_begin test hello,index! welcome,index! run index

可见 modue_init钩子上的应用绑定行为和模块绑定行为同时生效了，
如果希望当前模块的行为覆盖应用绑定的行为，可以使用：
return [
'module_init'    =>  [function($request){
    echo 'welcome,'.$request->module().'!';
},        
'_overlay'    =>  true,],
];

再次访问后，查看页面输出结果变成：
app_init testapp_begin testwelcome,index! run index


module_init钩子只执行了模块的行为。

我们给 Test行为增加一个额外的方法并且也绑定到 module_init钩子
namespace app\common\behavior;
class Test
{    
    public function appInit()      
    {        
        echo 'app_init test
';
        return false;
    }    
    public function appBegin()      
    {        
        echo 'app_begin test
';
        return false;
    }    
    public function sayHello($request)      
    {        
        echo 'say hello ' . $request->module() . '!';      
    }  
}


V5.0.4+版本开始支持指定方法（包括静态方法执行行为）

因为sayHello方法和钩子名称（ module_init对应的方法名应该是 moduleInit）不一致，
所以我们在绑定行为的时候需要改为：
return [
'module_init'    =>  [function($request){
        echo 'welcome,'.$request->module().'!';
    },         
    ['\app\common\behavior\Test','sayHello'],],
];

再次访问页面输出：
app_init test app_begin test hello,index! welcome,index!say hello index! run index
如果sayHello是一个静态方法的话，绑定方式需要从原来的
['\app\common\behavior\Test','sayHello'],
改为：
'\app\common\behavior\Test::sayHello',


动态绑定

配置方式绑定行为理解之后，我们再来看下如何动态绑定某个行为，动态绑定是指使用 Hook::add方法
动态给钩子添加一个行为方法，格式：

    Hook::add('钩子名称','行为定义','是否优先执行');

如果行为需要在应用里面被绑定，就在应用的公共文件 common.php中使用动态绑定代码，如果是模块的绑定行为，
那么也可以在模块的 common.php文件中使用动态绑定。

保持行为类不变的前提下，我们把前面的配置绑定方式改成动态绑定的方式，
首先在 application/common.php中添加如下代码：
use think\Hook;
Hook::add('app_init',['\app\common\behavior\Test','\app\common\behavior\Hello', ]);
Hook::add('app_begin',['\app\common\behavior\Test', ]);
Hook::add('module_init',[function($request){
        echo 'hello,'.$request->module().'!';
    },]
);

在 application/index/common.php中添加如下代码：
use think\Hook;
Hook::add('module_init',[function($request){
            echo 'welcome,'.$request->module().'!';
        },
        ['\app\common\behavior\Test','sayHello'],
    ]
);

然后清空应用和模块的tags.php文件内容，再次访问测试下，输出结果为：
app_init test app_begin test hello,index! welcome,index!say hello index! run index

效果一致。

示例的行为只是做了一个非常简单的输出操作，其实行为可以做很多的事情，
比如检查访问请求、权限检查、请求对象的属性和方法注入、甚至可以进行路由拦截等等，
你唯一需要注意的就是钩子的生效时间点，以及在这个钩子可以做什么有效操作。