Yii2.0源码分析之——控制器文件分析(Controller.php)创建动作、执行动作

在Yii中,当请求一个Url的时候,首先在application中获取request信息,然后由request通过urlManager解析出route,再在Module中根据route来创建controller并处理request。
如:http://www.yiifans.com/index.php?r=site/login。会使用SiteController里面的actionLogin动作来处理这个请求。

Yii中总共有三种控制器类

  • baseController.php        这个是下面两个的基类
  • consoleController.php   这个是控制台控制器
  • webController.php        这个是web控制器



先看看基类baseController.php,在基类中大致可分为三个部分

  • 和action相关的功能
  • 和render相关的功能
  • 其它功能


1、和action相关的函数

我们按照这些函数的调用顺序来一一说明

执行路由:public function run($route, $params = [])

复制代码
/*
* route值即可以为当前controller中的action id,
* 
* 也可为module id/controller id/action id/这种格式
* 如果以“/”开头,将于application来处理,否则,用控制器所属模块来处理
*/
public function run($route, $params = [])
{
        //先判断route中有没有“/”
        $pos = strpos($route, '/');
        if ($pos === false) {
                //如果没有“/”,则为action id,直接调用runAction来执行这个action。如:index
            return $this->runAction($route, $params);
        } elseif ($pos > 0) {
                //如果“/”在中间,由当前的模块来处理这个route。如:test/index
            return $this->module->runAction($route, $params);
        } else {
                //如果以“/”开头,则用当前的应用程序来处理这个route。如:/test/index;
            return Yii::$app->runAction(ltrim($route, '/'), $params);
        }
}
复制代码

执行动作:public function runAction($id, $params = [])

复制代码
/*
* $id 为action的id,如定义的actionIndex,那么id就为Index。
* 
*/
public function runAction($id, $params = [])
{
        //创建action
        $action = $this->createAction($id);
        if ($action === null) {
            throw new InvalidRouteException('Unable to resolve the request: ' . $this->getUniqueId() . '/' . $id);
        }

        Yii::trace("Route to run: " . $action->getUniqueId(), __METHOD__);

        if (Yii::$app->requestedAction === null) {
            Yii::$app->requestedAction = $action;
        }

        $oldAction = $this->action;
        $this->action = $action;

        //用来保存当前控制器的所有父模块,顺序为由子模块到父模块
        $modules = [];
        $runAction = true;

        /*
         * 获取当前控制器的所以的模块,并执行每个模块的beforeAction来检查当前的action是否可以执行,
         * 注意:getModules返回的数组顺序为:从父模块到子模块,
         * 所以在执行beforeAction的时候,先检查最外层的父模块,然后检查子模块。
         * 
         * 然而在执行afterAction的时候,顺序就反过来了,先执行子模块,最后执行父模块。
         * 
         */
        foreach ($this->getModules() as $module) {
            if ($module->beforeAction($action)) {
                array_unshift($modules, $module);
            } else {
                $runAction = false;
                break;
            }
        }

        $result = null;

        //如果所以的父模块都满足执行的条件
        if ($runAction) {
                /*
                 * 再判断当前控制器中是beforeAction,
                 * 最后由生成的action对象来执行runWithParams方法
                 * 
                 * 执行完后,再执行afterAction方法
                 */
            if ($this->beforeAction($action)) {
                $result = $action->runWithParams($params);
                $result = $this->afterAction($action, $result);
            }
        }

        //执行所有父模块的afterAction
        foreach ($modules as $module) {
            /** @var Module $module */
            $result = $module->afterAction($action, $result);
        }

        $this->action = $oldAction;

        return $result;
}
复制代码

创建动作 public function createAction($id)

复制代码
//由action id来创建action对象
public function createAction($id)
{
        //使用默认的action id ,默认值为:index
        if ($id === '') {
            $id = $this->defaultAction;
        }

        $actionMap = $this->actions();
        if (isset($actionMap[$id])) {
                //如果在actions方法中指定了独立的动作,则直接使用此动作。
            return Yii::createObject($actionMap[$id], [$id, $this]);
        } elseif (preg_match('/^[a-z0-9\-_]+$/', $id) && strpos($id, '--') === false && trim($id, '-') === $id) {
                /*
                 * action id由:a到z、0到9、、-、_ 这五种字符组成,
                 * 并且不能包含“--”
                 * 并且不能以“-”为开头或结尾
                 * 
                 * 先以“-”把id分隔为数组,再以“ ”连接到字符串,把每个单词首字母大写,最后把“ ”去掉,并和"action"连接
                 * 如;
                 * 1、new-post-v-4
                 * 2、['new','post','v','4']
                 * 3、new post v 4
                 * 4、New Post V 4
                 * 5、NewPostV4
                 * 6、actionNewPostV4
                 */
            $methodName = 'action' . str_replace(' ', '', ucwords(implode(' ', explode('-', $id))));
            if (method_exists($this, $methodName)) {
                    /*
                     * 如果当前控制器中存在这个actionXXX方法,
                     * 再通过反射生成方法,再次检查一遍,最后生成InlineAction
                     */
                $method = new ReflectionMethod($this, $methodName);
                if ($method->getName() === $methodName) {
                    return new InlineAction($id, $this, $methodName);
                }
            }
        }

        return null;
}
复制代码

所以,如果一个动作在定义的时候是用骆驼格式名称的,如actionNewArticle,那么写url的时候r=site/new-article。详情见Yii2.0中文开发向导——控制器(Controller)中的路由部分。

定义独立动作的数组:public function actions()

复制代码
/*
* 独立action定义
* 这个用来指定独立的action,返回格式为name-value的数组,name为action的id,value为action类的实现,如:
* return [
*     'action1' => 'appcomponentsAction1',
*     'action2' => [
*         'class' => 'appcomponentsAction2',
*         'property1' => 'value1',
*         'property2' => 'value2',
*     ],
* ];
* 这个主要是用于在子类中重写
*/
public function actions()
{
        return [];
}
复制代码

由createAction可知,当controller在创建action的时候,会根据动作ID先在这个数组里面查找,如果找到则返回这个动作。所以这里定义的动作的优先级要大于在控制器里面定义的actionXXX函数。

绑定动作的参数:public function bindActionParams($action, $params)

复制代码
/*
* 绑定action的参数。
* 比如定义了动作 actionCrate($id,$name=null)
* 那个这个函数的作用就是从params(一般为$_GET)中提取$id,$name,
* 
* 具体的实现在webController.php和consoleController.php中
*/
public function bindActionParams($action, $params)
{
        return [];
}
复制代码

beforeAction、afterAction,事件触发

复制代码
//在具体的动作执行之前会先执行beforeAction,如果返回false,则动作将不会被执行,
//后面的afterAction也不会执行(但父模块跌afterAction会执行)
public function beforeAction($action)
{
        $event = new ActionEvent($action);
        $this->trigger(self::EVENT_BEFORE_ACTION, $event);
        return $event->isValid;
}

//当前动作执行之后,执行afterAction
public function afterAction($action, $result)
{
        $event = new ActionEvent($action);
        $event->result = $result;
        $this->trigger(self::EVENT_AFTER_ACTION, $event);
        return $event->result;
}
复制代码

在这个都会触发事件,beforeAction触发EVENT_BEFORE_ACTION事件,afterAction触发EVENT_AFTER_ACTION

2、和render相关的功能

关于视图的可以参考Yii2.0中文开发向导——视图(View)
另外对于视图文件是怎么查找的请参考:Yii2.0源码分析之——视图文件分析(View.php)

获取、设置view组件:public function getView()、public function setView($view)

复制代码
//获取view组件,
public function getView()
{
        if ($this->_view === null) {
            $this->_view = Yii::$app->getView();
        }

        return $this->_view;
}
//设置view组件
public function setView($view)
{
        $this->_view = $view;
}
复制代码

渲染视图文件和布局文件(如果有布局的话):public function render($view, $params = [])

复制代码
//渲染视图文件和布局文件(如果有布局的话)
public function render($view, $params = [])
{
        //由view对象渲染视图文件
        $output = $this->getView()->render($view, $params, $this);
        //查找布局文件
        $layoutFile = $this->findLayoutFile($this->getView());
        if ($layoutFile !== false) {
                //由view对象渲染布局文件,
                //并把上面的视图结果作为content变量传递到布局中,所以布局中才会有$content变量来表示
            return $this->getView()->renderFile($layoutFile, ['content' => $output], $this);
        } else {
            return $output;
        }
}
复制代码

渲染视图文件,不会应用布局:public function renderPartial($view, $params = [])

//这个只渲染视图文件,不会应用布局
public function renderPartial($view, $params = [])
{
        return $this->getView()->render($view, $params, $this);
}

渲染文件:public function renderFile($file, $params = [])

//这个就是用来渲染一个文件,$file为文件实路径或别名路径
public function renderFile($file, $params = [])
{
        return $this->getView()->renderFile($file, $params, $this);
}

获取这个控制器对应的view的文件路径:public function getViewPath()

//获取这个控制器对应的view的文件路径,如@app/views/site/xxxx.php
public function getViewPath()
{
        return $this->module->getViewPath() . DIRECTORY_SEPARATOR . $this->id;
}

查找布局文件:protected function findLayoutFile($view)

复制代码
//查找布局文件
protected function findLayoutFile($view)
{
        $module = $this->module;
        //如果当前控制器设置了布局文件,则直接使用所设置的布局文件
        if (is_string($this->layout)) {
            $layout = $this->layout;
        } elseif ($this->layout === null) {
                //如果没有设置布局文件,则查找所有的父模块的布局文件。
            while ($module !== null && $module->layout === null) {
                $module = $module->module;
            }
            if ($module !== null && is_string($module->layout)) {
                $layout = $module->layout;
            }
        }

        //如果没有设置布局文件,返回false
        if (!isset($layout)) {
            return false;
        }

        /*
         * 布局文件有三种路径写法
         * 1、以“@”开头,这种会在别名路径中查找布局文件
         * 2、以“/”开头,这个会从应用程序的布局文件目录下面查找布局文件
         * 3、其它情况,   这个会从当前模块的布局文件目录下查查找布局文件
         */
        if (strncmp($layout, '@', 1) === 0) {
            $file = Yii::getAlias($layout);
        } elseif (strncmp($layout, '/', 1) === 0) {
            $file = Yii::$app->getLayoutPath() . DIRECTORY_SEPARATOR . substr($layout, 1);
        } else {
            $file = $module->getLayoutPath() . DIRECTORY_SEPARATOR . $layout;
        }

        //如果布局文件有文件扩展名,返回
        if (pathinfo($file, PATHINFO_EXTENSION) !== '') {
            return $file;
        }
        //加上默认的文件扩展名。
        $path = $file . '.' . $view->defaultExtension;
        //如果文件不存在,并且,默认的文件扩展名也不是php,则给加上php作为扩展名。
        if ($view->defaultExtension !== 'php' && !is_file($path)) {
            $path = $file . '.php';
        }

        return $path;
}
复制代码

3、其它功能

获取当前控制器所有的父模块:public function getModules()

复制代码
//获取当前控制器所有的父模块
public function getModules()
{
        $modules = [$this->module];
        $module = $this->module;
        while ($module->module !== null) {
                //由这里可知,返回的数组顺序为从父模块到子模块
            array_unshift($modules, $module->module);
            $module = $module->module;
        }
        return $modules;
}
复制代码

获取控制器id:public function getUniqueId()

复制代码
//返回控制器id
public function getUniqueId()
{
        //如果当前所属模块为application,则就为该id,否则要前面要加上模块id
        return $this->module instanceof Application ? $this->id : $this->module->getUniqueId() . '/' . $this->id;
}
复制代码

获取路由信息:public function getRoute()

//获取路由信息
public function getRoute()
{
        return $this->action !== null ? $this->action->getUniqueId() : $this->getUniqueId();
}

另外还有几个变量和2个事件

复制代码
//在执行beforeAction方法时触发的事件,
//如果对事件的isValid属性设置为false,将取消action的执行
const EVENT_BEFORE_ACTION = 'beforeAction';
//在执行afterAction方法是触发的事件
const EVENT_AFTER_ACTION = 'afterAction';
//控制器id
public $id;
//所属模块
public $module;
//控制器中默认动作
public $defaultAction = 'index';
//布局文件,如果设置为false,则不使用布局文件
public $layout;
//当前下面执行的action,可在事件中根据这个action来执行不同的操作
public $action;
//视图对象
private $_view;
 
原文地址:https://www.cnblogs.com/grimm/p/5446077.html