YII 的源码分析(-)

做为源码分析的首秀，我就挑了yii(读作歪依依而不是歪爱爱)；它的赞美之词我就不多说了，直接入正题。先准备材料，建议直从官网下载yii的源码包（1.1.15）。

在demos里边有一个最简单的应用—helloworld.就是用yii框架输出一句话：”hello world”;

我就从它下手，分析框架执行一个最小流程要经过哪些组件，浅析它的运行过程。

首先从单一入口文件开始阅读。（源码一般都是从调用处开始分析）

 index.php 只有两行代码，非常的简单，就是导入yiibase类 ，启动应用。

// include Yii bootstrap file
require_once(dirname(__FILE__).'/../../framework/yii.php');

Yii::createWebApplication()->run();

//YiiBase is a helper class serving common framework functionalities.

//YiiBase是一个助手类，它服务于整个框架。YiiBase代码有点长. 主要完成一些常量的定义和初始化。

代码到这里似乎就终结了，页面的内容也程现出来，可是框架到底做了些什么，我们却一无所知。所以我们需要把这一步进行分解，把里边的细节暴露出来。

Yii::createWebApplication()->run() 一共可以分成三部分

1. Yii
2. createWebApplication
3. run

Yii 这个东西是什么？ 这个很容易，从yii.php 可以找到这样一行代码class Yii extends YiiBase，说明它就是YiiBase的继承类，而且作者的扩展是留空的，所以Yii就是YiiBase的一个引用而已。

眼下还有两件事要搞清楚，一是这个new 做了什么操作，二是run做了什么操作？

先看第一个问题，new操作干了些什么事。

    public static function createWebApplication($config=null)
    {
        return self::createApplication('CWebApplication',$config);
    }

它又把任务传递给了createApplication：

         public static function createApplication($class,$config=null)
         {
                   return new $class($config);
         }

 

结合起来看，createWebApplication () 就是return new CWebApplication($config); 所以new 就是返回了CWebApplication的实例.然而这个CWebApplication类又在哪呢？它又是怎么引入的呢？它执行了哪些操作？带着这些问题，我们再次回到YiiBase.php.

在YiiBase.php里边定义了一个很长的数组，你可以找到：

'CWebApplication' => '/web/CWebApplication.php',

说胆CWebApplication这个类是属于自动加载的。关于它是如何实现自动加载的，可以查看spl_autoload_register的相关文档，在这里，我们先只要知道它是Yii框架给我们自动加载进来的就可以了。

我们继续往CWebApplication这个里边深挖。打开/web/CWebApplication.php这个文件，居然没有构造函数，根据我的经验，用了new的类，一般有一个构造函数进行一些初始化工作的，于是我试着往父类找找看。从 class CWebApplication extends CApplication 可以看出，父类是CApplication. 它确实有一个构造函数，代码如下：

public function __construct($config=null)
    {
        Yii::setApplication($this);

        // set basePath at early as possible to avoid trouble
        if(is_string($config))
            $config=require($config);

        if(isset($config['basePath']))
        {
            $this->setBasePath($config['basePath']);
            unset($config['basePath']);
        }
        else
            $this->setBasePath('protected');
        Yii::setPathOfAlias('application',$this->getBasePath());
        Yii::setPathOfAlias('webroot',dirname($_SERVER['SCRIPT_FILENAME']));
        if(isset($config['extensionPath']))
        {
            $this->setExtensionPath($config['extensionPath']);
            unset($config['extensionPath']);
        }
        else
            Yii::setPathOfAlias('ext',$this->getBasePath().DIRECTORY_SEPARATOR.'extensions');
        if(isset($config['aliases']))
        {
            $this->setAliases($config['aliases']);
            unset($config['aliases']);
        }

        $this->preinit();//预留

        $this->initSystemHandlers();//设置错误处理
        $this->registerCoreComponents(); //注册核心组件

        $this->configure($config); //加载配置文件

        $this->attachBehaviors($this->behaviors);//行为相关
        $this->preloadComponents(); //加载预加载组件

        $this->init(); 
    }

这样，new的过程就完结了，没有什么特别的，下面我们重点来看看run做了哪些工作。在CWebApplication 找不到run方法，它来自父类CApplication：

  public function run()
    {
        if($this->hasEventHandler('onBeginRequest'))
            $this->onBeginRequest(new CEvent($this));
        register_shutdown_function(array($this,'end'),0,false);
        $this->processRequest();
        if($this->hasEventHandler('onEndRequest'))
            $this->onEndRequest(new CEvent($this));
    }

重点放在：$this->processRequest(); 因为前面和后面部分都是注册事件相关的，当前条件下执行不到。而CApplication中的processRequest方法是抽象的，所以猜测是在子类中进行实现的。又回到CWebApplication中，查找processRequest:

    public function processRequest()
    {
        if(is_array($this->catchAllRequest) && isset($this->catchAllRequest[0]))
        {
            $route=$this->catchAllRequest[0];
            foreach(array_splice($this->catchAllRequest,1) as $name=>$value)
                $_GET[$name]=$value;
        }
        else
            $route=$this->getUrlManager()->parseUrl($this->getRequest());
        $this->runController($route);
    }

注意重点在$this->runController($route);

    public function runController($route)
    {
        if(($ca=$this->createController($route))!==null)
        {
            list($controller,$actionID)=$ca;
            $oldController=$this->_controller;
            $this->_controller=$controller;
            $controller->init();
            $controller->run($actionID);
            $this->_controller=$oldController;
        }
        else
            throw new CHttpException(404,Yii::t('yii','Unable to resolve the request "{route}".',
                array('{route}'=>$route===''?$this->defaultController:$route)));
    }

我们要注意的代码只有两行：

$controller->init();

$controller->run($actionID);

这里的$controller可以能过查看createController得知，就是默认的控制器Sitecontroller.php

而Action则是index,你问我是怎么看出来的？哈哈，我在猜不出来的地方echo或var_dump一下不就可以了吗？这么简单的逻辑，还轮不到xdebug 这样的神器出场。后面我们分析路由的时候，会知道，没有指明的时候，系统会有一个默认的index作为Action.

显然，init什么也没有做，看看run做了什么

Sitecontroller中没有run方法，又要去它的父类中查找。从定义：class SiteController extends CController得出父类。

在CController中有这个方法：

    public function run($actionID)
    {
        if(($action=$this->createAction($actionID))!==null)
        {
            if(($parent=$this->getModule())===null)
                $parent=Yii::app();
            if($parent->beforeControllerAction($this,$action))
            {
                $this->runActionWithFilters($action,$this->filters());
                $parent->afterControllerAction($this,$action);
            }
        }
        else
            $this->missingAction($actionID);
    }

查看$this->createAction($actionID)，得到return new CInlineAction($this,$actionID);

我们呆会再看这个CInlineAction,先看$this->runActionWithFilters($action,$this->filters());

 

public function runActionWithFilters($action,$filters)
         {
                   if(empty($filters)){
                            $this->runAction($action);
                   }
                   else
                   {
                            $priorAction=$this->_action;

                            $this->_action=$action;

                            CFilterChain::create($this,$action,$filters)->run();

                            $this->_action=$priorAction;
                   }
         }

显然$filters是空的，所以执行第一个表达式$this->runAction($action);

public function runAction($action)
         {
                   $priorAction=$this->_action;
                   $this->_action=$action;
                   if($this->beforeAction($action))
                   {
                            if($action->runWithParams($this->getActionParams())===false){
                                     $this->invalidActionParams($action);
                            }
                            else{
                                     $this->afterAction($action);
                            }
                   }
                   $this->_action=$priorAction;
         }

这段代码的重点是 $action->runWithParams($this->getActionParams())这一句；

这里的$action就是$this->createAction($actionID)返回的结果，而它的结果就是

return new CInlineAction($this,$actionID);

CInlineAction.php

是时候查看CInlineAction了；

 public function runWithParams($params)
         {
                   $methodName='action'.$this->getId();
                   $controller=$this->getController();
                   $method=new ReflectionMethod($controller, $methodName);
                   if($method->getNumberOfParameters()>0)
                            return $this->runWithParamsInternal($controller, $method, $params);
                   else
                            return $controller->$methodName();
         }

 

哇哦，好高级，居然还用了反射，不过我喜欢！

不过呢，打印$method发现：

object(ReflectionMethod)#6 (2) {
	["name"]=>
	string(11) "actionIndex"
	["class"]=>
	string(14) "SiteController"
	}

没有参数，所以此处代码相当于是执行了SiteController->actionIndex();

在class SiteController 中可以看到actionIndex 的定义 

 public function actionIndex()
         {
                   echo 'Hello World';
         }

于是就看到屏幕上那一句Hello World ，整个程序也就跑完了。也许有人要问了，为什么输出一句话还这么复杂，不是脱了裤子打屁吗? (请允许我的粗俗)；

如果是这么简单的需求，当然不可能这么干。举这个例子，只是说明yii的基础流程，为下面的复杂应用做一个过渡。

Yii作为一个优秀的oop框架，这个例子只是介绍了它的继承，接口，mvc中的vc特性，关于数据模型，我将在后面的分析中陆续给出。最终的目标，是利用yii框架简化我们的开发过程。

 

到此，我们整理一下流程中的主要继承关系：

 

class CComponent {
    public function __set($name,$value){}
    public function __get($name){}
}

abstract class CModule extends CComponent {
    function __construct(){
        echo 'CModule';
    }
}

abstract class CApplication extends CModule{
    function __construct(){
        echo 'CApplication';
    }

    public function run(){
        $this->processRequest();
    }
}

class CWebApplication extends CApplication{
    public $defaultController='site';
    public $layout='main';
    public function processRequest(){
        //$this->runController($route);
    }
}


$app = new CWebApplication->run();

这个继承关系很重要，后面的分析都会用到。

好了，今天的分析就在到了，如果有什么不妥的，请留言，如果觉得有帮助，请顺手点个推荐！