yii2源码学习笔记(十六)

Posted dragon16

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了yii2源码学习笔记(十六)相关的知识,希望对你有一定的参考价值。

Module类的最后代码

  1     /**
  2      * Registers sub-modules in the current module.
  3      * 注册子模块到当前模块
  4      * Each sub-module should be specified as a name-value pair, where
  5      * name refers to the ID of the module and value the module or a configuration
  6      * array that can be used to create the module. In the latter case, [[Yii::createObject()]]
  7      * will be used to create the module.
  8      * 子模块以键值对的方式指定,键名为模块ID,键值为模块对象或者用于创建模块对象的配置数组
  9      * If a new sub-module has the same ID as an existing one, the existing one will be overwritten silently.
 10      * 如果标识相同 会覆盖
 11      * The following is an example for registering two sub-modules:
 12      *
 13      * ~~~
 14      * [
 15      *     ‘comment‘ => [
 16      *         ‘class‘ => ‘app\modules\comment\CommentModule‘,
 17      *         ‘db‘ => ‘db‘,
 18      *     ],
 19      *     ‘booking‘ => [‘class‘ => ‘app\modules\booking\BookingModule‘],
 20      * ]
 21      * ~~~
 22      *
 23      * @param array $modules modules (id => module configuration or instances)
 24      */
 25     public function setModules($modules)
 26     {
 27         foreach ($modules as $id => $module) {
 28             $this->_modules[$id] = $module; //注册子模块,覆盖同名模块
 29         }
 30     }
 31 
 32     /**
 33      * Runs a controller action specified by a route.   运行路由中指定的控制器方法
 34      * This method parses the specified route and creates the corresponding child module(s), controller and action
 35      * instances. It then calls [[Controller::runAction()]] to run the action with the given parameters.
 36      * If the route is empty, the method will use [[defaultRoute]].
 37      * 解析指定的路由,创建对应的子模块、控制器、方法实例,调用[[Controller::runAction()]]给定的参数运行控制器中的方法
 38      * @param string $route the route that specifies the action.    指定行动的路线。
 39      * @param array $params the parameters to be passed to the action 操作的参数
 40      * @return mixed the result of the action.  操作结果
 41      * @throws InvalidRouteException if the requested route cannot be resolved into an action successfully
 42      */
 43     public function runAction($route, $params = [])
 44     {
 45         $parts = $this->createController($route); //根据路由创建控制器
 46         if (is_array($parts)) {
 47             /* @var $controller Controller */
 48             list($controller, $actionID) = $parts; //获得$actionId和$controller
 49             $oldController = Yii::$app->controller;
 50             Yii::$app->controller = $controller;
 51             $result = $controller->runAction($actionID, $params); //运行控制器 加载action方法
 52             Yii::$app->controller = $oldController;
 53 
 54             return $result;
 55         } else {
 56             $id = $this->getUniqueId();
 57             throw new InvalidRouteException(Unable to resolve the request " . ($id === ‘‘ ? $route : $id . / . $route) . ".);
 58         }
 59     }
 60 
 61     /**
 62      * Creates a controller instance based on the given route.
 63      * 根据给定的路径创建一个控制器实例。
 64      * The route should be relative to this module. The method implements the following algorithm
 65      * to resolve the given route:
 66      * 相对这个模块的路径。该方法实现了以下算法来解决给定的路径:
 67      * 1. If the route is empty, use [[defaultRoute]];   路径为空,调用默认的路径
 68      * 2. If the first segment of the route is a valid module ID as declared in [[modules]],
 69      *    call the module‘s `createController()` with the rest part of the route;
 70      * 3. If the first segment of the route is found in [[controllerMap]], create a controller
 71      *    based on the corresponding configuration found in [[controllerMap]];
 72      * 4. The given route is in the format of `abc/def/xyz`. Try either `abc\DefController`
 73      *    or `abc\def\XyzController` class within the [[controllerNamespace|controller namespace]].
 74      *
 75      * If any of the above steps resolves into a controller, it is returned together with the rest
 76      * part of the route which will be treated as the action ID. Otherwise, false will be returned.
 77      *
 78      * @param string $route the route consisting of module, controller and action IDs.
 79      * 由模块、控制器和动作标识组成的路径。
 80      * @return array|boolean If the controller is created successfully, it will be returned together
 81      * with the requested action ID. Otherwise false will be returned.
 82      * 如果控制器成功创建,将与被请求的操作标识一起返回,否则将返回false。
 83      * @throws InvalidConfigException if the controller class and its file do not match.
 84      * 如果控制器类及其文件不匹配,抛出异常
 85      */
 86     public function createController($route)
 87     {
 88         if ($route === ‘‘) {//路径为空,调用默认的路径
 89             $route = $this->defaultRoute;
 90         }
 91 
 92         // double slashes or leading/ending slashes may cause substr problem
 93         $route = trim($route, /); //去掉两边的反斜线,
 94         if (strpos($route, //) !== false) {
 95             return false; //如果路径中包含双斜线,返回false
 96         }
 97 
 98         if (strpos($route, /) !== false) {
 99             list ($id, $route) = explode(/, $route, 2);//将路径按反斜线分割为两个元素的数组,
100         } else {
101             $id = $route;
102             $route = ‘‘;
103         }
104 
105         // module and controller map take precedence  优先判断模块和控制器映射
106         if (isset($this->controllerMap[$id])) {
107             //如果$id是控制器ID,实例化控制器,返回控制器实例和后面的路径$route
108             $controller = Yii::createObject($this->controllerMap[$id], [$id, $this]);
109             return [$controller, $route];
110         }
111         $module = $this->getModule($id);
112         if ($module !== null) {//如果$id是模块ID,实例化控制器,返回控制器实例和后面的路径$route
113             return $module->createController($route);
114         }
115 
116         if (($pos = strrpos($route, /)) !== false) {
117             //上面两种情况都不是,则表示还有子模块,构造子模块的标识
118             $id .= / . substr($route, 0, $pos);
119             $route = substr($route, $pos + 1);
120         }
121 
122         $controller = $this->createControllerByID($id);
123         if ($controller === null && $route !== ‘‘) {//实例化控制器 组装控制器实例和后面的路径$route
124             $controller = $this->createControllerByID($id . / . $route);
125             $route = ‘‘;
126         }
127         //存在返回控制器实例和后面的路径$route,否则返回false
128         return $controller === null ? false : [$controller, $route];
129     }
130 
131     /**
132      * Creates a controller based on the given controller ID.
133      * 根据给定的控制器标识创建控制器
134      * The controller ID is relative to this module. The controller class
135      * should be namespaced under [[controllerNamespace]].
136      * 当前模块的控制器标识,控制器类应在 [[controllerNamespace]]的命名空间下
137      * Note that this method does not check [[modules]] or [[controllerMap]].
138      *
139      * @param string $id the controller ID  控制器标识
140      * @return Controller the newly created controller instance, or null if the controller ID is invalid.
141      *  新创建的控制器实例,为null则控制器标识无效
142      * @throws InvalidConfigException if the controller class and its file name do not match.
143      * This exception is only thrown when in debug mode.
144      */
145     public function createControllerByID($id)
146     {
147         $pos = strrpos($id, /);
148         if ($pos === false) {
149             $prefix = ‘‘; //是否包含反斜线,
150             $className = $id;
151         } else {//将路径按反斜线分割为两个元素
152             $prefix = substr($id, 0, $pos + 1);
153             $className = substr($id, $pos + 1);
154         }
155 
156         if (!preg_match(%^[a-z][a-z0-9\\-_]*$%, $className)) {
157             return null;//正则判断是否符合规则
158         }
159         if ($prefix !== ‘‘ && !preg_match(%^[a-z0-9_/]+$%i, $prefix)) {
160             return null;
161         }
162         //组装控制器名
163         $className = str_replace( , ‘‘, ucwords(str_replace(-,  , $className))) . Controller;
164         $className = ltrim($this->controllerNamespace . \\ . str_replace(/, \\, $prefix)  . $className, \\);
165         if (strpos($className, -) !== false || !class_exists($className)) {
166             return null; //控制器名有 ‘-’或不存在则为null
167         }
168 
169         if (is_subclass_of($className, yii\base\Controller)) {//检查对象是否有父类或子类
170             return Yii::createObject($className, [$id, $this]); //创建控制器
171         } elseif (YII_DEBUG) {
172             throw new InvalidConfigException("Controller class must extend from \\yii\\base\\Controller.");
173         } else {
174             return null;
175         }
176     }
177 
178     /**
179      * This method is invoked right before an action within this module is executed.
180      * 当前模块的Action执行前调用的方法,将触发[[EVENT_BEFORE_ACTION]]事件
181      * The method will trigger the [[EVENT_BEFORE_ACTION]] event. The return value of the method
182      * will determine whether the action should continue to run.
183      * 如果返回true,Action方法才会执行
184      * If you override this method, your code should look like the following:
185      *
186      * ```php
187      * public function beforeAction($action)
188      * {
189      *     if (parent::beforeAction($action)) {
190      *         // your custom code here
191      *         return true;  // or false if needed
192      *     } else {
193      *         return false;
194      *     }
195      * }
196      * ```
197      *
198      * @param Action $action the action to be executed. 要执行的操作
199      * @return boolean whether the action should continue to be executed.   是否执行操作
200      */
201     public function beforeAction($action)
202     {
203         $event = new ActionEvent($action);
204         $this->trigger(self::EVENT_BEFORE_ACTION, $event);//触发beforeAction事件
205         return $event->isValid;
206     }
207 
208     /**
209      * This method is invoked right after an action within this module is executed.
210      * 当前模块的Action执行后调用的方法,触发[[EVENT_AFTER_ACTION]]事件
211      * The method will trigger the [[EVENT_AFTER_ACTION]] event. The return value of the method
212      * will be used as the action return value.
213      * 如果返回true,后面的代码才会继续执行
214      * If you override this method, your code should look like the following:
215      *
216      * ```php
217      * public function afterAction($action, $result)
218      * {
219      *     $result = parent::afterAction($action, $result);
220      *     // your custom code here
221      *     return $result;
222      * }
223      * ```
224      *
225      * @param Action $action the action just executed.  执行的操作
226      * @param mixed $result the action return result.   执行结果
227      * @return mixed the processed action result.   处理结果
228      */
229     public function afterAction($action, $result)
230     {
231         $event = new ActionEvent($action);
232         $event->result = $result;
233         $this->trigger(self::EVENT_AFTER_ACTION, $event);//触发beforeAction事件
234         return $event->result;
235     }
236 }

 

以上是关于yii2源码学习笔记(十六)的主要内容,如果未能解决你的问题,请参考以下文章

yii2源码学习笔记(三)

yii2源码学习笔记(十九)

yii2源码学习笔记(四)

yii2源码学习笔记(六)

yii2源码学习笔记(七)

yii2源码学习笔记(五)