Yii分析13：Yii核心组件之AssetManager

  我们通过使用来讲解CAssetManager的使用和工作机制，可以直接看yii自带的demo-blog，打开blog的首页，会看到如下的引入js的html代码：

 

<linkrel="stylesheet"type="text/css"href="/yii/demos/blog/assets/d6bb6ebe/highlight.css"/>

<linkrel="stylesheet"type="text/css"href="/yii/demos/blog/assets/c2e28f0f/pager.css"/>

<scripttype="text/javascript"src="/yii/demos/blog/assets/d6112c6a/jquery.min.js"></script>

<scripttype="text/javascript"src="/yii/demos/blog/assets/d6112c6a/jquery.ba-bbq.js"></script>

	<link rel="stylesheet" type="text/css" href="/yii/demos/blog/assets/d6bb6ebe/highlight.css" /> 

	<link rel="stylesheet" type="text/css" href="/yii/demos/blog/assets/c2e28f0f/pager.css" /> 

	<script type="text/javascript" src="/yii/demos/blog/assets/d6112c6a/jquery.min.js"></script> 

	<script type="text/javascript" src="/yii/demos/blog/assets/d6112c6a/jquery.ba-bbq.js"></script> 

      这些js文件的路径都在assets文件夹下，assets后面跟着一个显然经过hash的文件夹路径，同属于jq的js代码的路径相同，这段代码从何而来呢？

 

      直接看view文件看不到任何引入js的代码，因此应该是使用widget引入的：

 

<?php $this->widget('zii.widgets.CListView', array(
    'dataProvider'=>$dataProvider,
    'itemView'=>'_view',
    'template'=>"{items}\n{pager}",
)); ?>

<?php $this->widget('zii.widgets.CListView', array(
	'dataProvider'=>$dataProvider,
	'itemView'=>'_view',
	'template'=>"{items}\n{pager}",
)); ?>

 

     这个widget也是yii自带的zii扩展，于是乎我们可以找到zii的CListView代码，而CListView又是继承CBaseListView，因此先看CBaseListView的run方法：

 

 

publicfunction run()
{
    $this->registerClientScript();

    echo CHtml::openTag($this->tagName,$this->htmlOptions)."\n";

    $this->renderKeys();
    $this->renderContent();

    echo CHtml::closeTag($this->tagName);
}

	public function run()
	{
		$this->registerClientScript();

		echo CHtml::openTag($this->tagName,$this->htmlOptions)."\n";

		$this->renderKeys();
		$this->renderContent();

		echo CHtml::closeTag($this->tagName);
	}

 

请注意第一个方法registerClientScript，这个方法是在CListView中实现的：

 

publicfunction registerClientScript()
{
……
    $cs=Yii::app()->getClientScript();
    $cs->registerCoreScript('jquery');
    $cs->registerCoreScript('bbq');
……
}

	public function registerClientScript()
	{
	……
		$cs=Yii::app()->getClientScript();
		$cs->registerCoreScript('jquery');
		$cs->registerCoreScript('bbq');
	……
	}

 

看到jquery和bbp似乎离真相近了些，接下来我们看CClientScript::registerCoreScript方法：

 

publicfunction registerCoreScript($name)
{
    $this->_hasScripts=true;
    $this->_coreScripts[$name]=$name;
    $params=func_get_args();
    $this->recordCachingAction('clientScript','registerCoreScript',$params);
}

	public function registerCoreScript($name)
	{
		$this->_hasScripts=true;
		$this->_coreScripts[$name]=$name;
		$params=func_get_args();
		$this->recordCachingAction('clientScript','registerCoreScript',$params);
	}

 

这里其实主要是记录了最终页面要render的js，而实际生成render的url是通过getCoreScriptUrl方法：

 

publicfunction getCoreScriptUrl()
{
    if($this->_baseUrl!==null)
        return$this->_baseUrl;
    else
        return$this->_baseUrl=Yii::app()->getAssetManager()->publish(YII_PATH.'/web/js/source');
}

	public function getCoreScriptUrl()
	{
		if($this->_baseUrl!==null)
			return $this->_baseUrl;
		else
			return $this->_baseUrl=Yii::app()->getAssetManager()->publish(YII_PATH.'/web/js/source');
	}

 

接下来我们看看publish的具体过程：

    publicfunction publish($path,$hashByName=false,$level=-1,$forceCopy=false)
    {
if(is_file($src))
        {
                $dir=$this->hash($hashByName ? basename($src) : dirname($src));
                $fileName=basename($src);
        ……
        elseif(is_dir($src))
        {
                $dir=$this->hash($hashByName ? basename($src) : $src);
                $dstDir=$this->getBasePath().DIRECTORY_SEPARATOR.$dir;
        ……
    }

	public function publish($path,$hashByName=false,$level=-1,$forceCopy=false)
	{
if(is_file($src))
		{
				$dir=$this->hash($hashByName ? basename($src) : dirname($src));
				$fileName=basename($src);
		……
		else if(is_dir($src))
		{
				$dir=$this->hash($hashByName ? basename($src) : $src);
				$dstDir=$this->getBasePath().DIRECTORY_SEPARATOR.$dir;
		……
	}

这里通过对路径做了hash处理，因此我们看到的路径是不规则的，而由于jq系列的js代码均在同一路径下（都在framework/web/js/source下），所以hash值是相同的。

 

另外，除了如上所述，CAssetManager使得多个模块可以复用相同的代码制外，使用CAssetManager的另外一个好处是安全隔离，将真实的代码放在受保护的路径下，按需加载。