程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> 關於PHP編程 >> yii2源碼學習筆記(八),yii2源碼學習筆記

yii2源碼學習筆記(八),yii2源碼學習筆記

編輯:關於PHP編程

yii2源碼學習筆記(八),yii2源碼學習筆記


Action是所有控制器的基類,接下來了解一下它的源碼。yii2\base\Action.php

  1 <?php
  2 /**
  3  * @link http://www.yiiframework.com/
  4  * @copyright Copyright (c) 2008 Yii Software LLC
  5  * @license http://www.yiiframework.com/license/
  6  */
  7 
  8 namespace yii\base;
  9 
 10 use Yii;
 11 
 12 /**
 13  * Action is the base class for all controller action classes.
 14  * 是所有控制器的基類
 15  * Action provides a way to divide a complex controller into
 16  * smaller actions in separate class files.
 17  * 控制器提供了一種重復使用操作方法的代碼,在多個控制器或不同的項目中使用
 18  * Derived classes must implement a method named `run()`. This method
 19  * will be invoked by the controller when the action is requested.
 20  * The `run()` method can have parameters which will be filled up
 21  * with user input values automatically according to their names.
 22  * 派生類必須實現一個名為run()的方法,這個方法會在控制器被請求時調用。
 23  * 它可以有參數,將用戶輸入值的根據他們的名字自動填補。
 24  * For example, if the `run()` method is declared as follows:
 25  * 例:run()方法調用聲明如下:
 26  * ~~~
 27  * public function run($id, $type = 'book') { ... }
 28  * ~~~
 29  *
 30  * And the parameters provided for the action are: `['id' => 1]`.
 31  * Then the `run()` method will be invoked as `run(1)` automatically.
 32  * 並且提供了操作的參數 ['id'=>1];
 33  * 當run(1)時自動調用run();
 34  * @property string $uniqueId The unique ID of this action among the whole application. This property is
 35  * read-only.
 36  * 整個應用程序中,這一行動的唯一標識。此屬性是只讀
 37  * @author Qiang Xue <[email protected]>
 38  * @since 2.0
 39  */
 40 class Action extends Component
 41 {
 42     /**
 43      * @var string ID of the action     ID的動作
 44      */
 45     public $id;
 46     /**
 47      * @var Controller|\yii\web\Controller the controller that owns this action
 48      * 擁有這一行動的控制器
 49      */
 50     public $controller;
 51 
 52 
 53     /**
 54      * Constructor.
 55      * 構造函數
 56      * @param string $id the ID of this action  這一行動的ID
 57      * @param Controller $controller the controller that owns this action 擁有這一行動的控制器
 58      * @param array $config name-value pairs that will be used to initialize the object properties
 59      * 用來初始化對象屬性的 name-value 
 60      */
 61     public function __construct($id, $controller, $config = [])
 62     {
 63         $this->id = $id;
 64         $this->controller = $controller;
 65         //調用父類的__construct()方法
 66         parent::__construct($config);
 67     }
 68 
 69     /**
 70      * Returns the unique ID of this action among the whole application.
 71      * 返回整個應用程序中的唯一ID。
 72      * @return string the unique ID of this action among the whole application.
 73      * 在整個應用程序中,這一行動的唯一ID。
 74      */
 75     public function getUniqueId()
 76     {
 77         return $this->controller->getUniqueId() . '/' . $this->id;
 78     }
 79 
 80     /**
 81      * Runs this action with the specified parameters.  用指定的參數運行此操作。
 82      * This method is mainly invoked by the controller. 該方法主要由控制器調用。
 83      *
 84      * @param array $params the parameters to be bound to the action's run() method.綁定到行動的run()方法的參數。
 85      * @return mixed the result of the action   行動的結果  命名參數是否有效的
 86      * @throws InvalidConfigException if the action class does not have a run() method
 87      * 如果動作類沒有run()方法 扔出異常
 88      */
 89     public function runWithParams($params)
 90     {
 91         if (!method_exists($this, 'run')) {//如果動作類沒有run()方法 拋出異常
 92             throw new InvalidConfigException(get_class($this) . ' must define a "run()" method.');
 93         }
 94         //調用bindActionParams()方法將參數綁定到動作。
 95         $args = $this->controller->bindActionParams($this, $params);
 96         //記錄跟蹤消息
 97         Yii::trace('Running action: ' . get_class($this) . '::run()', __METHOD__);
 98         if (Yii::$app->requestedParams === null) {
 99             //請求的動作提供的參數
100             Yii::$app->requestedParams = $args;
101         }
102         if ($this->beforeRun()) {
103             //執行run()方法
104             $result = call_user_func_array([$this, 'run'], $args);
105             $this->afterRun();
106 
107             return $result;
108         } else {
109             return null;
110         }
111     }
112 
113     /**
114      * This method is called right before `run()` is executed.
115      * ` run() `執行前方法被調用。
116      * You may override this method to do preparation work for the action run.
117      * 可以重寫此方法,為該操作運行的准備工作。
118      * If the method returns false, it will cancel the action.
119      * 如果該方法返回false,取消該操作。
120      * @return boolean whether to run the action.
121      */
122     protected function beforeRun()
123     {
124         return true;
125     }
126 
127     /**
128      * This method is called right after `run()` is executed.       ` run() `執行後 方法被調用。
129      * You may override this method to do post-processing work for the action run.
130      * 可以重寫此方法來處理該動作的後續處理工作。
131      */
132     protected function afterRun()
133     {
134     }
135 }

接下來我們看一下事件參數相關重要的一個類ActionEvent。yii2\base\ActionEvent.php

 1 <?php
 2 /**
 3  * @link http://www.yiiframework.com/
 4  * @copyright Copyright (c) 2008 Yii Software LLC
 5  * @license http://www.yiiframework.com/license/
 6  */
 7 
 8 namespace yii\base;
 9 
10 /**
11  * ActionEvent represents the event parameter used for an action event.
12  * 用於操作事件的事件參數
13  * By setting the [[isValid]] property, one may control whether to continue running the action.
14  * 通過設置[[isValid]]屬性,控制是否繼續運行action。
15  * @author Qiang Xue <[email protected]>
16  * @since 2.0
17  */
18 class ActionEvent extends Event
19 {
20     /**
21      * @var Action the action currently being executed
22      * 目前正在執行的行動
23      */
24     public $action;
25     /**
26      * @var mixed the action result. Event handlers may modify this property to change the action result.
27      * 操作結果 事件處理程序可以修改此屬性來更改操作結果。
28      */
29     public $result;
30     /**
31      * @var boolean whether to continue running the action. Event handlers of
32      * [[Controller::EVENT_BEFORE_ACTION]] may set this property to decide whether
33      * to continue running the current action.
34      * 是否繼續運行該動作。設置[[Controller::EVENT_BEFORE_ACTION]]屬性決定是否執行當前的操作
35      */
36     public $isValid = true;
37 
38 
39     /**
40      * Constructor.構造函數。
41      * @param Action $action the action associated with this action event.與此事件相關聯的動作。
42      * @param array $config name-value pairs that will be used to initialize the object properties
43      * 用來初始化對象屬性的 name-value
44      */
45     public function __construct($action, $config = [])
46     {
47         $this->action = $action;
48         parent::__construct($config);
49     }
50 }

今天最後看一下操作過濾器的基類吧ActionFilter。yii2\base\ActionFilter.php。

  1 <?php
  2 /**
  3  * @link http://www.yiiframework.com/
  4  * @copyright Copyright (c) 2008 Yii Software LLC
  5  * @license http://www.yiiframework.com/license/
  6  */
  7 
  8 namespace yii\base;
  9 
 10 /**
 11  * ActionFilter is the base class for action filters.
 12  * 是操作過濾器的基類。
 13  * An action filter will participate in the action execution workflow by responding to
 14  * the `beforeAction` and `afterAction` events triggered by modules and controllers.
 15  * 一個操作過濾器將參與行動的執行工作流程,通過觸發模型和控制器的`beforeAction` 和`afterAction` 事件
 16  * Check implementation of [[\yii\filters\AccessControl]], [[\yii\filters\PageCache]] and [[\yii\filters\HttpCache]] as examples on how to use it.
 17  * 
 18  * @author Qiang Xue <[email protected]>
 19  * @since 2.0
 20  */
 21 class ActionFilter extends Behavior
 22 {
 23     /**
 24      * @var array list of action IDs that this filter should apply to. If this property is not set,
 25      * then the filter applies to all actions, unless they are listed in [[except]].
 26      * 操作標識列表。如果該屬性未設置,過濾器適用於所有的行動,除非它們被列入[[except]]中。
 27      * If an action ID appears in both [[only]] and [[except]], this filter will NOT apply to it.
 28      * 如果一個操作ID 出現在[[only]] 和[[except]]中,該篩選器將不適用它
 29      * Note that if the filter is attached to a module, the action IDs should also include child module IDs (if any)
 30      * and controller IDs.
 31      * 如果過濾器是鏈接到一個模塊,操作檢測還應包括子模塊和控制器
 32      *
 33      * @see except
 34      */
 35     public $only;
 36     /**
 37      * @var array list of action IDs that this filter should not apply to.
 38      * 此篩選器不應適用於操作ID。
 39      * @see only
 40      */
 41     public $except = [];
 42 
 43 
 44     /**
 45      * @inheritdoc
 46      * 將行為對象附加到組件。
 47      */
 48     public function attach($owner)
 49     {
 50         $this->owner = $owner;
 51         $owner->on(Controller::EVENT_BEFORE_ACTION, [$this, 'beforeFilter']);
 52     }
 53 
 54     /**
 55      * @inheritdoc
 56      * 將行為對象和組件分離。
 57      */
 58     public function detach()
 59     {
 60         if ($this->owner) {
 61             $this->owner->off(Controller::EVENT_BEFORE_ACTION, [$this, 'beforeFilter']);
 62             $this->owner->off(Controller::EVENT_AFTER_ACTION, [$this, 'afterFilter']);
 63             $this->owner = null;
 64         }
 65     }
 66 
 67     /**
 68      * @param ActionEvent $event    在動作之前調用
 69      */
 70     public function beforeFilter($event)
 71     {
 72         if (!$this->isActive($event->action)) {
 73             return;
 74         }
 75 
 76         $event->isValid = $this->beforeAction($event->action);
 77         if ($event->isValid) {
 78             // call afterFilter only if beforeFilter succeeds    beforeFilter 執行成功調用afterFilter
 79             // beforeFilter and afterFilter should be properly nested  兩者要配合應用
 80             $this->owner->on(Controller::EVENT_AFTER_ACTION, [$this, 'afterFilter'], null, false);
 81         } else {
 82             $event->handled = true;
 83         }
 84     }
 85 
 86     /**
 87      * @param ActionEvent $event
 88      */
 89     public function afterFilter($event)
 90     {
 91         $event->result = $this->afterAction($event->action, $event->result);
 92         $this->owner->off(Controller::EVENT_AFTER_ACTION, [$this, 'afterFilter']);
 93     }
 94 
 95     /**
 96      * This method is invoked right before an action is to be executed (after all possible filters.)
 97      * 此方法是在一個動作之前被調用的(
 98      * You may override this method to do last-minute preparation for the action.
 99      * @param Action $action the action to be executed.要執行的動作
100      * @return boolean whether the action should continue to be executed.
101      * 是否應繼續執行該動作。
102      */
103     public function beforeAction($action)
104     {
105         return true;
106     }
107 
108     /**
109      * This method is invoked right after an action is executed.
110      * 此方法是在執行動作之後調用的。
111      * You may override this method to do some postprocessing for the action.
112      * @param Action $action the action just executed.  剛剛執行的動作
113      * @param mixed $result the action execution result 行動執行結果
114      * @return mixed the processed action result.   處理結果。
115      */
116     public function afterAction($action, $result)
117     {
118         return $result;
119     }
120 
121     /**
122      * Returns a value indicating whether the filer is active for the given action.
123      * 返回一個值,給定的過濾器的行動是否為是積極的。
124      * @param Action $action the action being filtered 被過濾的動作
125      * @return boolean whether the filer is active for the given action.
126      * 給定的過濾器的行動是否為是積極的。
127      */
128     protected function isActive($action)
129     {
130         if ($this->owner instanceof Module) {
131             // convert action uniqueId into an ID relative to the module
132             $mid = $this->owner->getUniqueId();
133             $id = $action->getUniqueId();
134             if ($mid !== '' && strpos($id, $mid) === 0) {
135                 $id = substr($id, strlen($mid) + 1);
136             }
137         } else {
138             $id = $action->id;
139         }
140         return !in_array($id, $this->except, true) && (empty($this->only) || in_array($id, $this->only, true));
141     }
142 }

 

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved