## 概述 | 版本 | 新增功能 | | --- | --- | | 5.0.4 | 行為類的方法采用駝峰法命名 | | | 行為綁定支持綁定到類的方法 | 行為（Behavior）是ThinkPHP擴展機制中比較關鍵的一項擴展，行為既可以獨立調用，也可以綁定到某個標簽中進行偵聽，在官方提出的CBD模式中行為也占了主要的地位，可見行為在ThinkPHP框架中意義非凡。 這里指的行為是一個比較抽象的概念，你可以把行為想象成在應用執行過程中的一個動作或者處理。在框架的執行流程中，例如路由檢測是一個行為，靜態緩存是一個行為，用戶權限檢測也是行為，大到業務邏輯，小到瀏覽器檢測、多語言檢測等等都可以當做是一個行為，甚至說你希望給你的網站用戶的第一次訪問彈出Hello，world！這些都可以看成是一種行為，行為的存在讓你無需改動框架和應用，而在外圍通過擴展或者配置來改變或者增加一些功能。 而不同的行為之間也具有位置共同性，比如，有些行為的作用位置都是在應用執行前，有些行為都是在模板輸出之后，我們把這些行為發生作用的位置稱之為標簽（位），當應用程序運行到這個標簽的時候，就會被攔截下來，統一執行相關的行為，類似于AOP編程中的“切面”的概念，給某一個切面綁定相關行為就成了一種類AOP編程的思想。 ## 行為標簽位 在定義行為之前，我們先來了解下系統有哪些標簽位，系統核心提供的標簽位置包括下面幾個（按照執行順序排列）： | 標簽位 | 描述 | | --- | --- | | `app_init` | 應用初始化標簽位 | | app\_begin | 應用開始標簽位 | | module\_init | 模塊初始化標簽位 | | action\_begin | 控制器開始標簽位 | | view\_filter | 視圖輸出過濾標簽位 | | app\_end | 應用結束標簽位 | | log\_write | 日志write方法標簽位 | | log\_write\_done | 日志寫入完成標簽位（`V5.0.10+`） | | response\_send | 響應發送標簽位（`V5.0.10+`） | | response\_end | 輸出結束標簽位（`V5.0.1+`） | 在每個標簽位置，可以配置多個行為定義，行為的執行順序按照定義的順序依次執行。除非前面的行為里面中斷執行了（某些行為可能需要中斷執行，例如檢測機器人或者非法執行行為），否則會繼續下一個行為的執行。 > 除了這些系統內置標簽之外，開發人員還可以在應用中添加自己的應用標簽。 ## 添加行為標簽位 可以使用`\think\Hook`類的`listen`方法添加自己的行為偵聽位置，例如： ~~~ Hook::listen('action_init'); ~~~ 可以給偵聽方法傳入參數（僅能傳入一個參數），該參數使用引用傳值，因此必須使用變量，例如： ~~~ 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`后 就會調用相關的方法。 `V5.0.4+`版本以上，行為類的方法需要采用駝峰法命名，上面的行為類需要改成： ~~~ namespace app\index\behavior; class Test { public function appInit(&$params) { } public function appEnd(&$params) { } } ~~~ ## 行為綁定 行為定義完成后，就需要綁定到某個標簽位置才能生效，否則是不會執行的。 使用Hook類的add方法注冊行為，例如： ~~~ // 注冊 app\index\behavior\CheckLang行為類到app_init標簽位 Hook::add('app_init','app\\index\\behavior\\CheckLang'); //注冊 app\admin\behavior\CronRun行為類到app_init標簽位 Hook::add('app_init','app\\admin\\behavior\\CronRun'); ~~~ 如果要批量注冊行為的話，可以使用： ~~~ Hook::add('app_init',['app\\index\\behavior\\CheckAuth','app\\index\\behavior\\CheckLang','app\\admin\\behavior\\CronRun']); ~~~ 當應用運行到`app_init`標簽位的時候，就會依次調用`app\index\behavior\CheckAuth`、`app\index\behavior\CheckLang`和`app\admin\behavior\CronRun`行為。如果其中一個行為中有中止代碼的話則后續不會執行，如果返回`false`則當前標簽位的后續行為將不會執行，但應用將繼續運行。 我們也可以直接在`APP_PATH`目錄下面或者模塊的目錄下面定義`tags.php`文件來統一定義行為，定義格式如下： ~~~ return [ 'app_init'=> [ 'app\\index\\behavior\\CheckAuth', 'app\\index\\behavior\\CheckLang' ], 'app_end'=> [ 'app\\admin\\behavior\\CronRun' ] ] ~~~ 如果`APP_PATH`目錄下面和模塊目錄下面的`tags.php`都定義了app\_init的行為綁定的話，會采用合并模式，如果希望覆蓋，那么可以在模塊目錄下面的`tags.php`中定義如下： ~~~ return [ 'app_init'=> [ 'app\\index\\behavior\\CheckAuth', '_overlay'=>true ], 'app_end'=> [ 'app\\admin\\behavior\\CronRun' ] ] ~~~ 如果某個行為標簽定義了`'_overlay' =>true` 就表示覆蓋之前的相同標簽下面的行為定義。 ## 閉包支持 可以不用定義行為直接把閉包函數綁定到某個標簽位，例如： ~~~ Hook::add('app_init',function(){ echo 'Hello,world!'; }); ~~~ 如果標簽位有傳入參數的話，閉包也可以支持傳入參數，例如： ~~~ Hook::listen('action_init',$params); Hook::add('action_init',function($params){ var_dump($params); }); ~~~ ## 直接執行行為 如果需要，你也可以不綁定行為標簽，直接調用某個行為，使用： ~~~ // 執行 app\index\behavior\CheckAuth行為類的run方法 并引用傳入params參數 $result = Hook::exec('app\\index\\behavior\\CheckAuth','run',$params); ~~~