thinkphp教程:TP的鉤子的兩種配置和兩種調用方法

thinkphp的鉤子行爲類是一個比較難以理解的問題,網上有很多寫thinkphp鉤子類的文章,我也是根據網上的文章來設置thinkphp的鉤子行爲的,但根據這些網上的文章,我在設置的過程中,嘗試了十幾次都沒有成功,不過,我還是沒有放棄,最後還是在一邊調節細節,一邊試驗的過程中實現了鉤子行爲的設置。下面是我個人的設置經驗,在這裏跟大家分享一下。

個人做了兩種設置,都試驗成功了,一個簡單點,在thinkphp的核心文件中模仿核心行爲類添加了另一個行爲類,下面是截圖:

我的虛擬主機配置文件夾是D:/think

Thinkphp是tp框架文件夾,配置過tp框架應該都知道Library是tp放核心文件的文件夾,Behavior文件夾則是tp的鉤子行爲類文件的核心文件夾,裏面放置着很多行爲類文件,我只是模仿這些鉤子行爲類文件在裏面建了一個鉤子行爲類文件adBehavior.class.php,內容如下:

<?php
namespace Behavior;
class adBehavior{
 function run($arg){
//在此介紹下,run必須的 ,細心的會在Think核心找到Behavior.class.php裏面有這樣一句話 abstract public function run(&$params); 
 echo '我是一條'.$arg['name'].'廣告,'.$arg['value'].'代言';
 }
}

設置好了自定義的鉤子行爲類之後,我們接下來就要利用這個鉤子行爲類促發鉤子的行爲了,```鉤子的行爲```說白了其實就是促發鉤子行爲類的run方法裏面的代碼執行,我這裏只是簡單的輸出run方法參數的內容,在應用中的,大家可以自由發揮。

下面是促發行爲的操作:

解釋一下:我這裏是Home模塊下面的IndexController控制器的登錄方法

namespace Home\Controller;
use Think\Controller;
use Think\Hook;//引進促發鉤子行爲的類,是爲下面的Hook::add()調用做伏筆的
class IndexController extends Controller {
 public function login(){
 //這裏我設置一個ad行爲的標籤,也就是給我自定義的adBehavior鉤子行爲類添加一個促發行爲的標識
 Hook::add('ad','Behavior\\adBehavior');
 //第一個是執行標籤的名稱,第二個參數是行爲的類的地址
 Hook::add('test', "Home\\Behaviors\\testBehavior");
 //Hook::add('test2', "Home\\Behaviors\\testBehavior");
 $param=array('name'=>'testBehavior');
 $param2=array('LIS'=>'LLISTION');
 $param3=array('music'=>'cangjingshikong');
 $this->assign('param',$param);
 $this->assign('param',$param2);
 $this->assign('param',$param3);
 $this->display();
 }

下面是login模板內容:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
 <title>ThinkPHP 行爲(Behavior)擴展以及插件(Plug or Hook)詳解(含實例)
 </title>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="description" content="Hook使用方法" />
</head>
<body>
<h1>How to used?</h1>
{:hook('ad', array('name'=>'AV','value'=>'*老師'))}
<div>————————————————分割線1——————————————————</div>
<div style="font-weight: bold ;color: #00ff00">{:hook('ad', array('name'=>'MV','value'=>'蒼井空老師'))}</div>
<div>————————————————分割線2——————————————————</div>
 <!--hook函數第一個參數是標籤的名稱,第二個參數隨意-->
 <!--tag函數第一個參數是標籤的名稱,第二個一定是變量,因爲tag函數是引址傳遞的參數-->
<div>hook函數:{:hook('test', array('name'=>'World'))}<hr/></div>
<div>tag函數:{:tag('mv',$param)}<hr/></div>
<hr/>
<div>tag函數:{:tag('action_begin',$param)}</div>
</body>
</html>

這裏的路徑我就不寫了吧,一般對tp框架了解的人都知道,這個模板login.html放在哪裏。

關於這個模板的內容,我已經提前把下面要講述的另一種設置鉤子行爲類方法的內容也放在這裏了,大家可以自行測試一下調用這個模板,如果你跟着我的思路設置了,我想它應該會輸出。

廢話不多說,下面是第二種自己設置行爲類的方法,這裏我是根據tp框架的手冊以及諸位網友的網文自己測試成功了的,大家按照我的思路設置就行了。只有你配置對了,我想應該不會出現太多問題。  

  1. 首先在你的模塊下面建一個文件夾Behaviors,再在Behaviors裏面創建自定義的鉤子行爲類,鉤子行爲類必須是xxxBehaviors.class.php的格式。  
  2. 其次在你的模塊下面的Conf文件夾中新增一個文件tags.php。  爲什麼要這樣,這是tp的語法,你照做就行了,當然你自己也可以探究一下。  這樣子說或許還不夠形象,下面我還是上代碼吧,本人描述比較差。  先截個圖顯示路徑吧,免得有的同學還是摸不着頭腦。

解釋一下上面的文件夾,Conf文件夾有的tp會自動生成,有的可能要你新建,Behaviors文件夾則是要你新建的,下面還是上代碼:在Behaviors文件夾裏面(完整路徑D:\think\application\Home\Behaviors\testBehavior.class.php)我自定義的鉤子行爲類的內容:

<?php
/**
 * Created by PhpStorm.
 * User: Administrator
 * Date: 2016/7/17
 * Time: 11:02
 */
namespace Home\Behaviors;
/*
 * 註冊鉤子行爲類,要觸發的行爲寫在run函數裏
 * */
class testBehavior extends \Think\Behavior{
 public function run(&$arg){
 echo 'test behavior=====下一行是參數<br/>'.$arg['name'];
 }
}

在Conf文件夾裏面(完整路徑D:\think\application\Home\Conf\tags.php,當然這是我的情況)tags.php的內容:

<?php
/**
 * Created by zhuowenfeng.
 * User: Administrator
 * Date: 2016/7/17
 * Time: 10:56
 */
return array(//'action_begin'=>array('Home\\Behaviors\\test','Home\\Behaviors\\test'),
 //一個標籤位可以有多個行爲,使用數組即可。 
 // 如果是3.2.1版本 則需要改成 
 'action_begin'=>array('Home\\Behaviors\\testBehavior','Home\\Behaviors\\testBehavior'),
 'mv'=>array('Home\\Behaviors\\mvBehavior','Home\\Behaviors\\mvBehavior')
);

解釋一下,上面tags.php文件的內容,我配置了兩個行爲標識,``action_begin``,``mv``,是跟login.html那裏相對應的,你可以回去仔細查看一下,login.html模板的內容,必定包含有``action_begin``,``mv``,這裏也是tp框架在tags.php設置行爲標識的語法,要是想問爲什麼可以自行探究,這裏不多說。

還有請注意:上面那個被我註釋掉的‘action_begin',其實是我的版本不適合這個語法,這是其他版本在tags.php配置行爲標識的語法,這裏tp裏面的文檔說的比較清楚,我就不多說了。如果,你的版本和我不同,那麼請用上面的語法嘗試一下,如果用上面的語法配置還是沒辦法配置成功,那麼可能是你配置錯了。

配置好了,那麼請你再嘗試調用模板login.html。我相信你一定能獲得你想要的配置結果的。

這裏提醒一句,請認真看我所做的註釋,那裏可以說也包含了很多信息。

接下來,我要講講設置監聽鉤子行爲類的兩個方法hook(),tag():

這兩個函數都是tp內置監聽鉤子行爲類的內置函數,可以在tp框架的函數庫functions.php文件中找得到。這裏只講他們的調用區別,其實已經在login.html模板文件中提到了,這裏就再次說明一下:

兩個函數在functions.php的代碼:

/**
 * 獲取和設置配置參數 支持批量定義
 * @param string|array $name 配置變量
 * @param mixed $value 配置值
 * @param mixed $default 默認值
 * @return mixed
 */
function hook($hook,$params=array()){
 \Think\Hook::listen($hook,$params); //監聽一個鉤子
}

/**
 * 處理標籤擴展
 * @param string $tag 標籤名稱
 * @param mixed $params 傳入參數
 * @return void
 */
function tag($tag, &$params=NULL) {
 \Think\Hook::listen($tag,$params);
}

之所以在這裏展示一下這兩個函數的內容,是爲了解釋它們的區別:

細心的你應該發現tag函數的$param參數值裏前面帶了一個···&···符號,沒有錯:這個符號就是引用變量的地址符號,所以tag函數的$param參數只能是變量,請不要懷疑,你可以測試一下不是變量的情況,呵呵。

它們的區別也在於此,hook可以引用任何參數,tag只能引用變量的參數

上面那個tags.php文件裏面我在每個標籤行爲的後面都重複配置了testBehavior自定義類,是爲了證明,一個標籤也可以對應多個行爲類,如果你配置成功了,那麼你運行login.html的時候,肯定發現login根據testBehavior設置的執行了兩次。

最後,總結一下:

tp框架的鉤子行爲類無非就是爲了在某個特定地點,特定時間促發某種行爲,這個是應用很廣的,本人姑且這麼認爲。比如,你想要在某個模板植入廣告,可以向我這樣子簡單的設置。然後,簡單的介紹tp行爲的引用步驟:

首先第一步,你要先配置好自己的行爲類,這是毋庸置疑的。

其次是促發的行爲,你必須在你自定義的行爲類的run裏面設置,在這裏實現你的任何行爲,run方法就是你配置行爲的地方。

然後,就是配置tags.php的行爲標識了

這裏你可以按照上面格式配置,當然,你有沒有細心的發現上面的IndexController.class.php裏面我多寫了幾行代碼:

//第一個是執行標籤的名稱,第二個參數是行爲的類的地址
 Hook::add('test', "Home\\Behaviors\\testBehavior");

其實這裏是動態添加行爲標識的代碼,也就是說,鉤子行爲的標籤行爲,也就是標識也可以動態添加的,你可以試試。

最後,就是監聽行爲了,監聽行爲就是引用tag方法或者hook方法了,在這裏你可以傳入參數,也可不傳,看你想怎麼做了。監聽行爲你可以在模板上監聽,也可以在其他地方監聽,比如控制器的方法中,這裏就不舉例了,你可以自己試試,我之所以在模板中舉例,完全是爲了看到效果,畢竟做實驗看不到你要的結果,是證明不了你的實驗是個成功的實驗的。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章