Yii過濾器簡(jiǎn)介

過濾器是一段代碼，可被配置在控制器動(dòng)作執(zhí)行之前或之后執(zhí)行。例如， 訪問控制過濾器將被執(zhí)行以確保在執(zhí)行請(qǐng)求的動(dòng)作之前用戶已通過身份驗(yàn)證；性能過濾器可用于測(cè)量控制器執(zhí)行所用的時(shí)間。

一個(gè)動(dòng)作可以有多個(gè)過濾器。過濾器執(zhí)行順序?yàn)樗鼈兂霈F(xiàn)在過濾器列表中的順序。過濾器可以阻止動(dòng)作及后面其他過濾器的執(zhí)行。

過濾器有兩種寫法：

基于方法的過濾器

基于自定義過濾器類的過濾器

無論哪種過濾器，都必須在控制器中重寫控制器的public function filters()方法，設(shè)置哪個(gè)過濾器對(duì)哪個(gè)動(dòng)作起作用。

基于方法的過濾器

編寫基于方法的過濾器，要經(jīng)過三步：

在控制器中編寫動(dòng)作（Action）；

在控制器中編寫過濾器函數(shù)，函數(shù)名必須以filter為前綴，如：function filterAccessControl()；

重寫父類CController的filters()方法，定義過濾器與動(dòng)作的關(guān)系；

實(shí)例：

1. <?php  
2.  
3.   class UserController extends CController{  
4.  
5.     **  
6.  
7.      * 第一步：創(chuàng)建動(dòng)作  
8.  
9.      */  
10.  
11.       function actionAdd(){   
12.  
13.         echo "actionAdd";  
14.  
15.       }  
16.  
17.       /**  
18.  
19.       * 第二步：創(chuàng)建基于方法的過濾器  
20.  
21.        */ 
22.  
23.       public function filterAddFilter($filterChain) {  
24.  
25.         echo "基于方法的過濾器UserController.filterAdd<br>";  
26.  
27.         $filterChain->run();  
28.  
29.       }  
30.  
31.       /**  
32.  
33.       * 第三步：重寫父類CController的filters()方法，定義過濾器與動(dòng)作的關(guān)系  
34.  
35.       * @see CController::filters()  
36.  
37.       */ 
38.  
39.       public function filters(){  
40.  
41.         return array(  
42.  
43.       //定義過濾器與動(dòng)作的關(guān)聯(lián)關(guān)系  
44.  
45.           'addFilter + add',  
46.  
47. //         array(  
48.  
49. //             'application.filters.TestFilter',            
50.  
51. //         ),  
52.  
53.             //Vevb.com 
54.  
55.       );  
56.  
57.     }  
58.  
59.   }  

自定義過濾器類

自定義過濾器類，需要單獨(dú)寫一個(gè)過濾器類，并繼承CFilter類，重寫CFilter類下的部分方法。大家可以看一下CFilter類的代碼，該類代碼不多，還是很容易看懂的。

自定義過濾器實(shí)例：

1. <?php  
2.  
3. class TestFilter extends CFilter{  
4.  
5.   /**  
6.  
7.    * Performs the pre-action filtering.  
8.  
9.    * @param CFilterChain $filterChain the filter chain that the filter is on.  
10.  
11.    * @return boolean whether the filtering process should continue and the action  
12.  
13.    * should be executed.  
14.  
15.    */ 
16.  
17.   protected function preFilter($filterChain)  
18.  
19.   {  
20.  
21.     echo "--->TestFilter.preFilter.<br>";  
22.  
23.     return true;  
24.  
25.   }  
26.  
27.      
28.  
29.   /**  
30.  
31.    * Performs the post-action filtering.  
32.  
33.    * @param CFilterChain $filterChain the filter chain that the filter is on.  
34.  
35.    */ 
36.  
37.   protected function postFilter($filterChain)  
38.  
39.   {  
40.  
41.     echo "--->TestFilter.postFilter.<br>";  
42.  
43.   }  
44.  
45. }  

在控制器中注冊(cè)該自定義過濾器與動(dòng)作的綁定關(guān)系：

1. /** 
2.  
3. * 第三步：重寫父類CController的filters()方法，定義過濾器與動(dòng)作的關(guān)系  
4.  
5. * @see CController::filters()  
6.  
7. */ 
8.  
9. ublic function filters(){  
10.  
11. return array(  
12.  
13.   //定義過濾器與動(dòng)作的關(guān)聯(lián)關(guān)系  
14.  
15.     'addFilter + add',  
16.  
17.       array(  
18.  
19.           'application.filters.TestFilter',            
20.  
21.       ),  
22.  
23. );  

我自定義了一個(gè)過濾器：TestFilter，繼承了CFilter類，重寫了CFilter類的兩個(gè)主要方法：preFilter（前控制器，在動(dòng)作執(zhí)行前運(yùn)行）和postFilter（后控制器，在動(dòng)作執(zhí)行后運(yùn)行）。

兩種控制器的執(zhí)行順序

假設(shè)我將上面編寫的自定義過濾器類與動(dòng)作actionAdd綁定，那么，自定義過濾器繼承自父類CFilter兩個(gè)方法：preFilter和postFilter，與綁定的actionAdd之間的執(zhí)行順序是怎樣的呢？

經(jīng)過試驗(yàn)，執(zhí)行順序?yàn)椋篊Filter::preFilter--------->UserController::actionAdd--------->CFilter::postFilter。

也就是說，在動(dòng)作執(zhí)行前后都可以執(zhí)行過濾操作。

那么文章開頭說“過濾器可以阻止動(dòng)作及后面其他過濾器的執(zhí)行”是怎么做到的呢？

看了CFilter::preFilter的官方注釋就知道了：

@return boolean whether the filtering process should continue and the action should be executed。

CFilter::preFilter函數(shù)默認(rèn)return

true;即，默認(rèn)執(zhí)行后面的動(dòng)作和后過濾器。如果在自定義過濾器類中，重寫CFilter::preFilter方法，并return

false；就可以阻止后面的動(dòng)作和過濾器執(zhí)行了！

使用過濾器

過濾器本質(zhì)上是一類特殊的 行為，所以使用過濾器和 使用 行為一樣。 可以在控制器類中覆蓋它的 yii/base/Controller::behaviors() 方法來申明過濾器，如下所示：

1. public function behaviors() 
2.  
3. { 
4.  
5.   return [ 
6.  
7.     [ 
8.  
9.       'class' => 'yii/filters/HttpCache', 
10.  
11.       'only' => ['index', 'view'], 
12.  
13.       'lastModified' => function ($action, $params) { 
14.  
15.         $q = new /yii/db/Query(); 
16.  
17.         return $q->from('user')->max('updated_at'); 
18.  
19.       }, 
20.  
21.     ], 
22.  
23.   ]; 
24.  
25. } 

控制器類的過濾器默認(rèn)應(yīng)用到該類的 所有 動(dòng)作，你可以配置yii/base/ActionFilter::only屬性明確指定控制器應(yīng)用到哪些動(dòng)作。 在上述例子中，HttpCache 過濾器只應(yīng)用到index和view動(dòng)作。 也可以配置yii/base/ActionFilter::except屬性使一些動(dòng)作不執(zhí)行過濾器。

除了控制器外，可在 模塊或應(yīng)用主體 中申明過濾器。 申明之后，過濾器會(huì)應(yīng)用到所屬該模塊或應(yīng)用主體的 所有 控制器動(dòng)作， 除非像上述一樣配置過濾器的 yii/base/ActionFilter::only 和 yii/base/ActionFilter::except 屬性。

補(bǔ)充: 在模塊或應(yīng)用主體中申明過濾器，在yii/base/ActionFilter::only 和 yii/base/ActionFilter::except 屬性中使用路由 代替動(dòng)作ID， 因?yàn)樵谀K或應(yīng)用主體中只用動(dòng)作ID并不能唯一指定到具體動(dòng)作。.

當(dāng)一個(gè)動(dòng)作有多個(gè)過濾器時(shí)，根據(jù)以下規(guī)則先后執(zhí)行：

預(yù)過濾

按順序執(zhí)行應(yīng)用主體中behaviors()列出的過濾器。

按順序執(zhí)行模塊中behaviors()列出的過濾器。

按順序執(zhí)行控制器中behaviors()列出的過濾器。

如果任意過濾器終止動(dòng)作執(zhí)行，后面的過濾器（包括預(yù)過濾和后過濾）不再執(zhí)行。

成功通過預(yù)過濾后執(zhí)行動(dòng)作。

后過濾

倒序執(zhí)行控制器中behaviors()列出的過濾器。

倒序執(zhí)行模塊中behaviors()列出的過濾器。

倒序執(zhí)行應(yīng)用主體中behaviors()列出的過濾器。

創(chuàng)建過濾器

繼承 yii/base/ActionFilter 類并覆蓋 yii/base/ActionFilter::beforeAction() 和/或 yii/base/ActionFilter::afterAction() 方法來創(chuàng)建動(dòng)作的過濾器，前者在動(dòng)作執(zhí)行之前執(zhí)行，后者在動(dòng)作執(zhí)行之后執(zhí)行。 yii/base/ActionFilter::beforeAction() 返回值決定動(dòng)作是否應(yīng)該執(zhí)行， 如果為false，之后的過濾器和動(dòng)作不會(huì)繼續(xù)執(zhí)行。

下面的例子申明一個(gè)記錄動(dòng)作執(zhí)行時(shí)間日志的過濾器。

1. namespace app/components; 
2.  
3. use Yii; 
4.  
5. use yii/base/ActionFilter; 
6.  
7. ?class ActionTimeFilter extends ActionFilter 
8.  
9. { 
10.  
11.   private $_startTime; 
12.  
13.  
14.  
15.   public function beforeAction($action) 
16.  
17.   { 
18.  
19.     $this->_startTime = microtime(true); 
20.  
21.     return parent::beforeAction($action); 
22.  
23.   } 
24.  
25.   public function afterAction($action, $result) 
26. //Vevb.com 
27.   { 
28.  
29.     $time = microtime(true) - $this->_startTime; 
30.  
31.     Yii::trace("Action '{$action->uniqueId}' spent $time second."); 
32.  
33.     return parent::afterAction($action, $result); 
34.  
35.   } 
36.  
37. } 

核心過濾器

Yii提供了一組常用過濾器，在yii/filters命名空間下，接下來我們簡(jiǎn)要介紹這些過濾器。

1.yii/filters/AccessControl

AccessControl提供基于yii/filters/AccessControl::rules規(guī)則的訪問控制。 特別是在動(dòng)作執(zhí)行之前，訪問控制會(huì)檢測(cè)所有規(guī)則并找到第一個(gè)符合上下文的變量（比如用戶IP地址、登錄狀態(tài)等等）的規(guī)則， 來決定允許還是拒絕請(qǐng)求動(dòng)作的執(zhí)行，如果沒有規(guī)則符合，訪問就會(huì)被拒絕。

如下示例表示表示允許已認(rèn)證用戶訪問create 和 update 動(dòng)作，拒絕其他用戶訪問這兩個(gè)動(dòng)作。

1. use yii/filters/AccessControl; 
2.  
3. public function behaviors() 
4.  
5. { 
6.  
7.   return [ 
8.  
9.     'access' => [ 
10.  
11.       'class' => AccessControl::className(), 
12.  
13.       'only' => ['create', 'update'], 
14.  
15.       'rules' => [ 
16.  
17.         // 允許認(rèn)證用戶 
18.  
19.         [ 
20.  
21.           'allow' => true, 
22.  
23.           'roles' => ['@'], 
24.  
25.         ], 
26.  
27.         // 默認(rèn)禁止其他用戶 
28.  
29.       ], 
30.  
31.     ], 
32.  
33.   ]; 
34.  
35. } 

2.認(rèn)證方法過濾器

認(rèn)證方法過濾器通過HTTP Basic Auth或OAuth 2 來認(rèn)證一個(gè)用戶，認(rèn)證方法過濾器類在 yii/filters/auth 命名空間下。

如下示例表示可使用yii/filters/auth/HttpBasicAuth來認(rèn)證一個(gè)用戶，它使用基于HTTP基礎(chǔ)認(rèn)證方法的令牌。 注意為了可運(yùn)行，yii/web/User::identityClass 類必須 實(shí)現(xiàn) yii/web/IdentityInterface::findIdentityByAccessToken()方法。

1. use yii/filters/auth/HttpBasicAuth; 
2.  
3. public function behaviors() 
4.  
5. { 
6.  
7.   return [ 
8.  
9.     'basicAuth' => [ 
10.  
11.       'class' => HttpBasicAuth::className(), 
12.  
13.     ], 
14.  
15.   ]; 
16.  
17. } 

認(rèn)證方法過濾器通常在實(shí)現(xiàn)RESTful API中使用。

3.yii/filters/ContentNegotiator

ContentNegotiator支持響應(yīng)內(nèi)容格式處理和語言處理。 通過檢查 GET 參數(shù)和 Accept HTTP頭部來決定響應(yīng)內(nèi)容格式和語言。

如下示例，配置ContentNegotiator支持JSON和XML響應(yīng)格式和英語（美國）和德語。

1. use yii/filters/ContentNegotiator; 
2.  
3. use yii/web/Response; 
4.  
5. public function behaviors() 
6.  
7. { 
8.  
9.   return [ 
10.  
11.     [ 
12.  
13.       'class' => ContentNegotiator::className(), 
14.  
15.       'formats' => [ 
16.  
17.         'application/json' => Response::FORMAT_JSON, 
18.  
19.         'application/xml' => Response::FORMAT_XML, 
20.  
21.       ], 
22.  
23.       'languages' => [ 
24.  
25.         'en-US', 
26.  
27.         'de', 
28.  
29.       ], 
30.  
31.     ], 
32.  
33.   ]; 
34.  
35. } 

在應(yīng)用主體生命周期過程中檢測(cè)響應(yīng)格式和語言簡(jiǎn)單很多， 因此ContentNegotiator設(shè)計(jì)可被引導(dǎo)啟動(dòng)組件調(diào)用的過濾器。 如下例所示可以將它配置在應(yīng)用主體配置。

1. use yii/filters/ContentNegotiator; 
2.  
3. use yii/web/Response; 
4.   
5. [ 
6.  
7.   'bootstrap' => [ 
8.  
9.     [ 
10.  
11.       'class' => ContentNegotiator::className(), 
12.  
13.       'formats' => [ 
14.  
15.         'application/json' => Response::FORMAT_JSON, 
16.  
17.         'application/xml' => Response::FORMAT_XML, 
18.  
19.       ], 
20.  
21.       'languages' => [ 
22.  
23.         'en-US', 
24.  
25.         'de', 
26.  
27.       ], 
28.  
29.     ], 
30.  
31.   ], 
32.  
33. ]; 

補(bǔ)充: 如果請(qǐng)求中沒有檢測(cè)到內(nèi)容格式和語言，使用formats和languages第一個(gè)配置項(xiàng)。

4.yii/filters/HttpCache

HttpCache利用Last-Modified 和 Etag HTTP頭實(shí)現(xiàn)客戶端緩存。例如：

1. use yii/filters/HttpCache; 
2.  
3. public function behaviors() 
4.  
5. { 
6.  
7.   return [ 
8.  
9.     [ 
10.  
11.       'class' => HttpCache::className(), 
12.  
13.       'only' => ['index'], 
14.  
15.       'lastModified' => function ($action, $params) { 
16.  
17.         $q = new /yii/db/Query(); 
18.  
19.         return $q->from('user')->max('updated_at'); 
20.  
21.       }, 
22.  
23.     ], 
24.  
25.   ]; 
26.  
27. } 

5.yii/filters/PageCache

PageCache實(shí)現(xiàn)服務(wù)器端整個(gè)頁面的緩存。如下示例所示，PageCache應(yīng)用在index動(dòng)作， 緩存整個(gè)頁面60秒或post表的記錄數(shù)發(fā)生變化。它也會(huì)根據(jù)不同應(yīng)用語言保存不同的頁面版本。

1. use yii/filters/PageCache; 
2.  
3. use yii/caching/DbDependency; 
4.  
5. public function behaviors() 
6.  
7. { 
8.  
9.   return [ 
10.  
11.     'pageCache' => [ 
12.  
13.       'class' => PageCache::className(), 
14.  
15.       'only' => ['index'], 
16.  
17.       'duration' => 60, 
18.  
19.       'dependency' => [ 
20.  
21.         'class' => DbDependency::className(), 
22.  
23.         'sql' => 'SELECT COUNT(*) FROM post', 
24.  
25.       ], 
26.  
27.       'variations' => [ 
28.  
29.         /Yii::$app->language, 
30.  
31.       ] 
32.  
33.     ], 
34.  
35.   ]; 
36.  
37. } 

6.yii/filters/RateLimiter

RateLimiter 根據(jù) 漏桶算法 來實(shí)現(xiàn)速率限制。

7.yii/filters/VerbFilter

VerbFilter檢查請(qǐng)求動(dòng)作的HTTP請(qǐng)求方式是否允許執(zhí)行，如果不允許，會(huì)拋出HTTP 405異常。 如下示例，VerbFilter指定CRUD動(dòng)作所允許的請(qǐng)求方式。

1. use yii/filters/VerbFilter; 
2.  
3. public function behaviors() 
4.  
5. { 
6.  
7.   return [ 
8.  
9.     'verbs' => [ 
10.  
11.       'class' => VerbFilter::className(), 
12.  
13.       'actions' => [ 
14.  
15.         'index' => ['get'], 
16.  
17.         'view'  => ['get'], 
18.  
19.         'create' => ['get', 'post'], 
20.  
21.         'update' => ['get', 'put', 'post'], 
22.  
23.         'delete' => ['post', 'delete'], 
24.  
25.       ], 
26.  
27.     ], 
28.  
29.   ]; 
30.  
31. } 

8.yii/filters/Cors

跨域資源共享 CORS 機(jī)制允許一個(gè)網(wǎng)頁的許多資源（例如字體、JavaScript等） 這些資源可以通過其他域名訪問獲取。 特別是JavaScript's AJAX 調(diào)用可使用 XMLHttpRequest 機(jī)制，由于同源安全策略該跨域請(qǐng)求會(huì)被網(wǎng)頁瀏覽器禁止. CORS定義瀏覽器和服務(wù)器交互時(shí)哪些跨域請(qǐng)求允許和禁止。

yii/filters/Cors 應(yīng)在 授權(quán) / 認(rèn)證 過濾器之前定義，以保證CORS頭部被發(fā)送。

1. use yii/filters/Cors; 
2.  
3. use yii/helpers/ArrayHelper; 
4.  
5. public function behaviors() 
6.  
7. { 
8.  
9.   return ArrayHelper::merge([ 
10. //Vevb.com 
11.     [ 
12.  
13.       'class' => Cors::className(), 
14.  
15.     ], 
16.  
17.   ], parent::behaviors()); 
18.  
19. } 

Cors 可轉(zhuǎn)為使用 cors 屬性。

cors['Origin']: 定義允許來源的數(shù)組，可為['*'] (任何用戶) 或 ['http://www.myserver.net', 'http://www.myotherserver.com']. 默認(rèn)為 ['*'].

cors['Access-Control-Request-Method']: 允許動(dòng)作數(shù)組如 ['GET', 'OPTIONS', 'HEAD']. 默認(rèn)為 ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'].

cors['Access-Control-Request-Headers']: 允許請(qǐng)求頭部數(shù)組，可為 ['*'] 所有類型頭部 或 ['X-Request-With'] 指定類型頭部. 默認(rèn)為 ['*'].

cors['Access-Control-Allow-Credentials']: 定義當(dāng)前請(qǐng)求是否使用證書，可為 true, false 或 null (不設(shè)置). 默認(rèn)為null.

cors['Access-Control-Max-Age']: 定義請(qǐng)求的有效時(shí)間，默認(rèn)為 86400.

例如，允許來源為 http://www.myserver.net 和方式為 GET, HEAD 和 OPTIONS 的CORS如下：

1. use yii/filters/Cors; 
2.  
3. use yii/helpers/ArrayHelper; 
4.  
5. public function behaviors() 
6.  
7. { 
8.  
9.   return ArrayHelper::merge([ 
10.  
11.     [ 
12.  
13.       'class' => Cors::className(), 
14.  
15.       'cors' => [ 
16.  
17.         'Origin' => ['http://www.myserver.net'], 
18.  
19.         'Access-Control-Request-Method' => ['GET', 'HEAD', 'OPTIONS'], 
20.  
21.       ], 
22.  
23.     ], 
24.  
25.   ], parent::behaviors()); 
26.  
27. } 

可以覆蓋默認(rèn)參數(shù)為每個(gè)動(dòng)作調(diào)整CORS 頭部。例如，為login動(dòng)作增加Access-Control-Allow-Credentials參數(shù)如下所示：

1. use yii/filters/Cors; 
2.  
3. use yii/helpers/ArrayHelper; 
4.  
5. public function behaviors() 
6.  
7. { 
8.  
9.   return ArrayHelper::merge([ 
10.  
11.     [ 
12.  
13.       'class' => Cors::className(), 
14.  
15.       'cors' => [ 
16.  
17.         'Origin' => ['http://www.myserver.net'], 
18.  
19.         'Access-Control-Request-Method' => ['GET', 'HEAD', 'OPTIONS'], 
20.  
21.       ], 
22.  
23.       'actions' => [ 
24.  
25.         'login' => [ 
26.  
27.           'Access-Control-Allow-Credentials' => true, 
28. //Vevb.com 
29.         ] 
30.  
31.       ] 
32.  
33.     ], 
34.  
35.   ], parent::behaviors()); 
36.  
37. }