首页 > 程序开发 > Web开发 > php >

thinkphp核心源码注释|Template.class.php

2016-07-21

* ThinkPHP内置模板引擎类 * 支持XML标签和普通标签的模板解析 * 编译型模板引擎 支持动态缓存 * 模版 里面 最好的一个部分了


// +----------------------------------------------------------------------
namespace Think;
/**
 * ThinkPHP内置模板引擎类
 * 支持XML标签和普通标签的模板解析
 * 编译型模板引擎 支持动态缓存
 * 模版 里面 最好的一个部分了
 */
class  Template {

    // 模板页面中引入的标签库列表
    protected   $tagLib          =   array();// 模版看来是把,模版的操作,跟标签操作进行分类
    // 这个有点像是那个 mysql 里面的 表达式转义
    // 当前模板文件
    protected   $templateFile    =   '';// 当前模版文件 处理 估计就是要引入进来,
    // 这样对于class 来说 里面的 文件 跟 输入的接口进行了各种统一,
    // 其实现在的 Php 编程已经上升了一个新的高度,那个就是 java类似的情况了
    // 编程了 class编程为基础 function 进行辅助的状态呢。

    // 总结: 标签 ---》 模版文件

    // 模板变量
    public      $tVar            =   array(); // 模版变量 1
    public      $config          =   array(); // 模版变量 2
    private     $literal         =   array(); // 模版变量 3
    private     $block           =   array(); // 模版变量 4

    /**
     * 架构函数
     * @access public
     * 构造函数吧,哥哥,你这个注释,
     */
    public function __construct(){
        $this->config['cache_path']         =   C('CACHE_PATH');// 配置路径
        $this->config['template_suffix']    =   C('TMPL_TEMPLATE_SUFFIX');// 好像是 模版文件后缀
        $this->config['cache_suffix']       =   C('TMPL_CACHFILE_SUFFIX');// 生成文件后缀
        $this->config['tmpl_cache']         =   C('TMPL_CACHE_ON');// 是否开启模版缓存
        $this->config['cache_time']         =   C('TMPL_CACHE_TIME');// 模版缓存时间
        $this->config['taglib_begin']       =   $this->stripPreg(C('TAGLIB_BEGIN'));// 标签开始符号
        $this->config['taglib_end']         =   $this->stripPreg(C('TAGLIB_END'));// 标签结束符号
        $this->config['tmpl_begin']         =   $this->stripPreg(C('TMPL_L_DELIM'));//     'TMPL_L_DELIM'          =>  '{',            // 模板引擎普通标签开始标记
        $this->config['tmpl_end']           =   $this->stripPreg(C('TMPL_R_DELIM'));//'TMPL_R_DELIM'          =>  '}',            // 模板引擎普通标签结束标记
        $this->config['default_tmpl']       =   C('TEMPLATE_NAME');// 默认模版名i在
        $this->config['layout_item']        =   C('TMPL_LAYOUT_ITEM');//'TMPL_LAYOUT_ITEM'      =>  '{__CONTENT__}', // 布局模板的内容替换标识
    }

    private function stripPreg($str) {
        return str_replace(
            array('{','}','(',')','|','[',']','-','+','*','.','^','?'),
            array('\{','\}','\(','\)','\|','\[','\]','\-','\+','\*','\.','\^','\?'),
            $str);        
    }// 这个就是个大剂量 的str_replace













    // 模板变量获取和设置
    public function get($name) { // 获取模版变量数据
        if(isset($this->tVar[$name]))
            return $this->tVar[$name];
        else
            return false;
        // 其实可以直接这样改写 一句话搞定,哈哈
        // return isset($this->tVar[$name])?$this->tVar[$name]:false;
    }

    public function set($name,$value) {// 这个设置很简洁
        $this->tVar[$name]= $value;
    }

    /**
     * 加载模板
     * @access public
     * @param string $templateFile 模板文件
     * @param array  $templateVar 模板变量
     * @param string $prefix 模板标识前缀
     * @return void
     * 加载模版
     */
    public function fetch($templateFile,$templateVar,$prefix='') {
        $this->tVar         =   $templateVar;// 模版变量数组 这个是当前模版的变量数组
        // extract($vars, EXTR_OVERWRITE);
        // 这个是一个大量 使用的函数,这个是比较不错的,就是在加载缓存文件之前,先把对应的变量,进行了赋值
        // 其实人家给的 变量名字就是很明显的了,
        $templateCacheFile  =   $this->loadTemplate($templateFile,$prefix);// 加载对应的模版文件 并且生成其缓存文件,
        Storage::load($templateCacheFile,$this->tVar,null,'tpl');
        // 这个干了这个事情:第一 :将模版数组进行赋值,第二,根据对应的模版文件生成对应的模版缓存文件,第三: 进行变量赋值,并且 include 模版。

    } // 总结:一手抓变量,一手抓模版,融会贯通,哈哈哈

    /**
     * 加载主模板并缓存
     * @access public
     * @param string $templateFile 模板文件
     * @param string $prefix 模板标识前缀
     * @return string
     * @throws ThinkExecption
     */
    public function loadTemplate ($templateFile,$prefix='') {// 牛叉,居然还有模版前缀,
        // $templateFile  是一个标准的 模版文件, 准确的来说应该是标准的 完整路径的模版文件
        if(is_file($templateFile)) {
            $this->templateFile    =  $templateFile;
            // 读取模板文件内容
            $tmplContent =  file_get_contents($templateFile);
        }else{
            $tmplContent =  $templateFile;
        }
        // 我去,如果是文件,并且可以找到,那么,就读取文件内容,否则,直接视作是文件内容啊,这个有点霸气啊

         // 根据模版文件名定位缓存文件
        $tmplCacheFile = $this->config['cache_path'].$prefix.md5($templateFile).$this->config['cache_suffix'];
        // 个人感觉就是 md5加密的模版名字,果不其然啊,哈哈

        // 判断是否启用布局
        if(C('LAYOUT_ON')) { // 我个人不喜欢这个布局。
            if(false !== strpos($tmplContent,'{__NOLAYOUT__}')) { // 可以单独定义不使用布局
                $tmplContent = str_replace('{__NOLAYOUT__}','',$tmplContent);
            }else{ // 替换布局的主体内容
                $layoutFile  =  THEME_PATH.C('LAYOUT_NAME').$this->config['template_suffix'];
                // 检查布局文件
                if(!is_file($layoutFile)) {
                    E(L('_TEMPLATE_NOT_EXIST_').':'.$layoutFile);
                }
                $tmplContent = str_replace($this->config['layout_item'],$tmplContent,file_get_contents($layoutFile));
            }
        }// 如果启用的布局文件,就对布局文件里面的内容 进行替换。
        // 编译模板内容
        $tmplContent =  $this->compiler($tmplContent);// 对内容,进行编译
        Storage::put($tmplCacheFile,trim($tmplContent),'tpl');// 写入文件
        return $tmplCacheFile;// 返回文件路径,即可。
    }





























    /**
     * 编译模板文件内容
     * @access protected
     * @param mixed $tmplContent 模板内容
     * @return string
     * 这个是编译
     * 干大活的,就是 就是 个总的 外包
     */
    protected function compiler($tmplContent) {
        //模板解析
        $tmplContent =  $this->parse($tmplContent); // 这个获取 模版的解析文件  {$a} ==> /is', array($this, 'restoreLiteral'), $tmplContent);


        // 添加安全代码
        $tmplContent =  ''.$tmplContent;// 这里的 添加了 框架里面的安全代码
        // 优化生成的php代码
        $tmplContent = str_replace('?>config['taglib_begin'];// 标签开启
        $end        =   $this->config['taglib_end'];// 标签关闭
        // 检查include语法
        $content    =   $this->parseInclude($content); // 解析模版里面的 这个 include 标签,变成php 里面的 include
        // 检查PHP语法
        $content    =   $this->parsePhp($content);// 解析模版里的 默认的php标签
        // 首先替换literal标签内容
        // 替换这种标签了,嘿嘿,搞不懂啦
        $content    =   preg_replace_callback('/'.$begin.'literal'.$end.'(.*?)'.$begin.'\/literal'.$end.'/is', array($this, 'parseLiteral'),$content);

        // 获取需要引入的标签库列表
        // 标签库只需要定义一次,允许引入多个一次
        // 一般放在文件的最前面
        // 格式:
        // 当TAGLIB_LOAD配置为true时才会进行检测
        if(C('TAGLIB_LOAD')) { // 特殊模版解析  特殊判断
            $this->getIncludeTagLib($content);
            if(!empty($this->tagLib)) {
                // 对导入的TagLib进行解析
                foreach($this->tagLib as $tagLibName) {
                    $this->parseTagLib($tagLibName,$content); // 标签整理 1
                }
            }
        }
        // 预先加载的标签库 无需在每个模板中使用taglib标签加载 但必须使用标签库XML前缀
        if(C('TAGLIB_PRE_LOAD')) { // 这里的 一个解析了 特殊判读
            $tagLibs =  explode(',',C('TAGLIB_PRE_LOAD'));
            foreach ($tagLibs as $tag){
                $this->parseTagLib($tag,$content); // 标签整理 2
            }
        }
        // 内置标签库 无需使用taglib标签导入就可以使用 并且不需使用标签库XML前缀
        $tagLibs =  explode(',',C('TAGLIB_BUILD_IN'));// 解析标签库
        foreach ($tagLibs as $tag){
            $this->parseTagLib($tag,$content,true); // 标签整理 3
        }
        //解析普通模板标签 {$tagName}
        $content = preg_replace_callback('/('.$this->config['tmpl_begin'].')([^\d\w\s'.$this->config['tmpl_begin'].$this->config['tmpl_end'].'].+?)('.$this->config['tmpl_end'].')/is', array($this, 'parseTag'),$content);
        return $content;
    }// 把里面各种需要解析的东西,按分类进行 解析。
    // 剩下的就是 那个 各种仔细的 解析

















    // 检查PHP语法
    protected function parsePhp($content) {
        if(ini_get('short_open_tag')){// 如果开启了短标签,
            // '."\n", $content );
        }
        // PHP语法检查
        // 'TMPL_DENY_PHP'         =>  false, // 默认模板引擎是否禁用PHP原生代码
        if(C('TMPL_DENY_PHP') && false !== strpos($content,'config['taglib_begin'].'layout\s(.+?)\s*?\/'.$this->config['taglib_end'].'/is',$content,$matches);
        if($find) { // 如果存在这种徐奥布局的标签
            //替换Layout标签
            $content    =   str_replace($matches[0],'',$content);
            //解析Layout标签
            $array      =   $this->parseXmlAttrs($matches[1]);
            if(!C('LAYOUT_ON') || C('LAYOUT_NAME') !=$array['name'] ) {
                // 读取布局模板
                $layoutFile =   THEME_PATH.$array['name'].$this->config['template_suffix'];
                $replace    =   isset($array['replace'])?$array['replace']:$this->config['layout_item'];
                // 替换布局的主体内容
                $content    =   str_replace($replace,$content,file_get_contents($layoutFile));
            }
        }else{
            $content = str_replace('{__NOLAYOUT__}','',$content);
        }
        return $content;
    }
    // 总结:替换布局标签
    // 写代码的思路就是,先从大的思路布局,然后,在进入细节。
    // 过年了,对不住观众啦,哈哈,就弄了这两个

















    // 解析模板中的include标签
    // 解析 include 里面的标签
    protected function parseInclude($content, $extend = true) {
        // 解析继承
        if($extend)
            $content    =   $this->parseExtend($content);// 处理了 个 拓展
        // 解析布局
        $content    =   $this->parseLayout($content); // 替换到 里面的 layout 标签
        // 读取模板中的include标签
        $find       =   preg_match_all('/'.$this->config['taglib_begin'].'include\s(.+?)\s*?\/'.$this->config['taglib_end'].'/is',$content,$matches);
        if($find) {
            for($i=0;$i<$find;$i++) {
                $include    =   $matches[1][$i];
                $array      =   $this->parseXmlAttrs($include);
                $file       =   $array[&#39;file&#39;];
                unset($array[&#39;file&#39;]);
                $content    =   str_replace($matches[0][$i],$this->parseIncludeItem($file,$array,$extend),$content);
            }
        }
        return $content;
    }
    // 就是个解析了

    // 解析模板中的extend标签
    protected function parseExtend($content) {
        $begin      =   $this->config[&#39;taglib_begin&#39;];
        $end        =   $this->config[&#39;taglib_end&#39;];        
        // 读取模板中的继承标签
        $find       =   preg_match(&#39;/&#39;.$begin.&#39;extend\s(.+?)\s*?\/&#39;.$end.&#39;/is&#39;,$content,$matches);
        if($find) {
            //替换extend标签
            $content    =   str_replace($matches[0],&#39;&#39;,$content);
            // 记录页面中的block标签
            preg_replace_callback(&#39;/&#39;.$begin.&#39;block\sname=[\&#39;"](.+?)[\&#39;"]\s*?&#39;.$end.&#39;(.*?)&#39;.$begin.&#39;\/block&#39;.$end.&#39;/is&#39;, array($this, &#39;parseBlock&#39;),$content);
            // 读取继承模板
            $array      =   $this->parseXmlAttrs($matches[1]);
            $content    =   $this->parseTemplateName($array[&#39;name&#39;]);
            $content    =   $this->parseInclude($content, false); //对继承模板中的include进行分析
            // 替换block标签
            $content = $this->replaceBlock($content);
        }else{
            $content    =   preg_replace_callback(&#39;/&#39;.$begin.&#39;block\sname=[\&#39;"](.+?)[\&#39;"]\s*?&#39;.$end.&#39;(.*?)&#39;.$begin.&#39;\/block&#39;.$end.&#39;/is&#39;, function($match){return stripslashes($match[2]);}, $content);
        }
        return $content;
    }// 就是个解析了
    // 基本的思路,就是,先替换系统标签,然后,进行正则选择,然后对选择后的文件
    // 进行替换 完成。

    /**
     * 分析XML属性
     * @access private
     * @param string $attrs  XML属性字符串
     * @return array
     */
    private function parseXmlAttrs($attrs) {
        $xml        =   &#39;&#39;;
        $xml        =   simplexml_load_string($xml);
        if(!$xml)
            E(L(&#39;_XML_TAG_ERROR_&#39;));
        $xml        =   (array)($xml->tag->attributes());
        $array      =   array_change_key_case($xml[&#39;@attributes&#39;]);
        return $array;
    }// 就是个解析了

    /**
     * 替换页面中的literal标签
     * @access private
     * @param string $content  模板内容
     * @return string|false
     */
    private function parseLiteral($content) {
        if(is_array($content)) $content = $content[1];
        if(trim($content)==&#39;&#39;)  return &#39;&#39;;
        //$content            =   stripslashes($content);
        $i                  =   count($this->literal);
        $parseStr           =   "{C}";
        $this->literal[$i]  =   $content;
        return $parseStr;
    }// 就是个解析了

    /**
     * 还原被替换的literal标签
     * @access private
     * @param string $tag  literal标签序号
     * @return string|false
     */
    private function restoreLiteral($tag) {
        if(is_array($tag)) $tag = $tag[1];
        // 还原literal标签
        $parseStr   =  $this->literal[$tag];
        // 销毁literal记录
        unset($this->literal[$tag]);
        return $parseStr;
    }// 就是个解析了

    /**
     * 记录当前页面中的block标签
     * @access private
     * @param string $name block名称
     * @param string $content  模板内容
     * @return string
     */
    private function parseBlock($name,$content = &#39;&#39;) {
        if(is_array($name)){
            $content = $name[2];
            $name    = $name[1];
        }
        $this->block[$name]  =   $content;
        return &#39;&#39;;
    }// 就是个解析了

    /**
     * 替换继承模板中的block标签
     * @access private
     * @param string $content  模板内容
     * @return string
     */
    private function replaceBlock($content){
        static $parse = 0;
        $begin = $this->config[&#39;taglib_begin&#39;];
        $end   = $this->config[&#39;taglib_end&#39;];
        $reg   = &#39;/(&#39;.$begin.&#39;block\sname=[\&#39;"](.+?)[\&#39;"]\s*?&#39;.$end.&#39;)(.*?)&#39;.$begin.&#39;\/block&#39;.$end.&#39;/is&#39;;
        if(is_string($content)){ // 这个是个字符串
            do{
                $content = preg_replace_callback($reg, array($this, &#39;replaceBlock&#39;), $content);
            } while ($parse && $parse--);
            return $content;
        } elseif(is_array($content)){ // 居然是个 数组
            if(preg_match(&#39;/&#39;.$begin.&#39;block\sname=[\&#39;"](.+?)[\&#39;"]\s*?&#39;.$end.&#39;/is&#39;, $content[3])){ //存在嵌套,进一步解析
                $parse = 1;
                $content[3] = preg_replace_callback($reg, array($this, &#39;replaceBlock&#39;), "{$content[3]}{$begin}/block{$end}");
                return $content[1] . $content[3];
            } else {
                $name    = $content[2];
                $content = $content[3];
                $content = isset($this->block[$name]) ? $this->block[$name] : $content;
                return $content;
            }
        }
    }// 就是个解析了

    /**
     * 搜索模板页面中包含的TagLib库
     * 并返回列表
     * @access public
     * @param string $content  模板内容
     * @return string|false
     */
    public function getIncludeTagLib(& $content) {
        //搜索是否有TagLib标签
        $find = preg_match(&#39;/&#39;.$this->config[&#39;taglib_begin&#39;].&#39;taglib\s(.+?)(\s*?)\/&#39;.$this->config[&#39;taglib_end&#39;].&#39;\W/is&#39;,$content,$matches);
        if($find) {
            //替换TagLib标签
            $content        =   str_replace($matches[0],&#39;&#39;,$content);
            //解析TagLib标签
            $array          =   $this->parseXmlAttrs($matches[1]);
            $this->tagLib   =   explode(&#39;,&#39;,$array[&#39;name&#39;]);
        }
        return;
    }// 就是个解析了

















    /**
     * TagLib库解析
     * @access public
     * @param string $tagLib 要解析的标签库
     * @param string $content 要解析的模板内容
     * @param boolean $hide 是否隐藏标签库前缀
     * @return string
     */
    public function parseTagLib($tagLib,&$content,$hide=false) {
        $begin      =   $this->config[&#39;taglib_begin&#39;];//  标签开始 位置标记
        $end        =   $this->config[&#39;taglib_end&#39;];// 标签结束 位置标记
        if(strpos($tagLib,&#39;\\&#39;)){// 如果存在 标签库命名 说白了,就是 有了
            // 支持指定标签库的命名空间
            $className  =   $tagLib;// 转换了 存储了一下
            $tagLib     =   substr($tagLib,strrpos($tagLib,&#39;\\&#39;)+1);
        }else{
            $className  =   &#39;Think\\Template\TagLib\\&#39;.ucwords($tagLib);            
        }// 找到要解析的标签库的名称
        $tLib       =   \Think\Think::instance($className);// 实例化对应的类名
        $that       =   $this;
        foreach ($tLib->getTags() as $name=>$val){ // 对全部的标签进行解析处理
            $tags = array($name);
            if(isset($val[&#39;alias&#39;])) {// 别名设置
                $tags       = explode(&#39;,&#39;,$val[&#39;alias&#39;]);
                $tags[]     =  $name;
            }
            $level      =   isset($val[&#39;level&#39;])?$val[&#39;level&#39;]:1;
            $closeTag   =   isset($val[&#39;close&#39;])?$val[&#39;close&#39;]:true;
            foreach ($tags as $tag){ // 对这些标签 进行更多的处理
                $parseTag = !$hide? $tagLib.&#39;:&#39;.$tag: $tag;// 实际要解析的标签名称
                if(!method_exists($tLib,&#39;_&#39;.$tag)) {// 这些各种各样的别名解析方式
                    // 别名可以无需定义解析方法
                    $tag  =  $name;
                }
                $n1 = empty($val[&#39;attr&#39;])?&#39;(\s*?)&#39;:&#39;\s([^&#39;.$end.&#39;]*)&#39;;
                $this->tempVar = array($tagLib, $tag);

                if (!$closeTag){ // 非闭合标签
                    $patterns       = &#39;/&#39;.$begin.$parseTag.$n1.&#39;\/(\s*?)&#39;.$end.&#39;/is&#39;;
                    $content        = preg_replace_callback($patterns, function($matches) use($tLib,$tag,$that){
                        return $that->parseXmlTag($tLib,$tag,$matches[1],$matches[2]);
                    },$content);
                }else{ // 闭合标签
                    $patterns       = &#39;/&#39;.$begin.$parseTag.$n1.$end.&#39;(.*?)&#39;.$begin.&#39;\/&#39;.$parseTag.&#39;(\s*?)&#39;.$end.&#39;/is&#39;;
                    for($i=0;$i<$level;$i++) {
                        $content=preg_replace_callback($patterns,function($matches) use($tLib,$tag,$that){
                            return $that->parseXmlTag($tLib,$tag,$matches[1],$matches[2]);
                        },$content);
                    }
                }
            }
        }
    }

    /**
     * 解析标签库的标签
     * 需要调用对应的标签库文件解析类
     * @access public
     * @param object $tagLib  标签库对象实例
     * @param string $tag  标签名
     * @param string $attr  标签属性
     * @param string $content  标签内容
     * @return string|false
     */
    public function parseXmlTag($tagLib,$tag,$attr,$content) {
        if(ini_get(&#39;magic_quotes_sybase&#39;))
            $attr   =   str_replace(&#39;\"&#39;,&#39;\&#39;&#39;,$attr); // 把单引号
        $parse      =   &#39;_&#39;.$tag;
        $content    =   trim($content);
        $tags       =   $tagLib->parseXmlAttr($attr,$tag);
        return $tagLib->$parse($tags,$content);
    }// 解析掉 对应

    /**
     * 模板标签解析
     * 格式: {TagName:args [|content] }
     * @access public
     * @param string $tagStr 标签内容
     * @return string
     */
    public function parseTag($tagStr){
        if(is_array($tagStr)) $tagStr = $tagStr[2];// 如果 是个
        //if (MAGIC_QUOTES_GPC) {
            $tagStr = stripslashes($tagStr);// 删除反斜杠:
        //}
        $flag   =  substr($tagStr,0,1);// 去掉了 标志位1
        $flag2  =  substr($tagStr,1,1); // 标志位2
        $name   = substr($tagStr,1); // 从 第一位开始
        if(&#39;$&#39; == $flag && &#39;.&#39; != $flag2 && &#39;(&#39; != $flag2){ //解析模板变量 格式 {$varName}
            // 类似于这种
            return $this->parseVar($name); // 或者这种 普通的 标签之类的
        }elseif(&#39;-&#39; == $flag || &#39;+&#39;== $flag){ // 输出计算 +a
            return  &#39;&#39;;
        }elseif(&#39;:&#39; == $flag){ // 输出某个函数的结果  这个找到了 {:U()}
            return  &#39;&#39;;
        }elseif(&#39;~&#39; == $flag){ // 执行某个函数 {}
            return  &#39;&#39;;// 这里作为普通函数进行输出一下
        }elseif(substr($tagStr,0,2)==&#39;//&#39; || (substr($tagStr,0,2)==&#39;/*&#39; && substr(rtrim($tagStr),-2)==&#39;*/&#39;)){
            //注释标签
            // 如果这种 普通的标签 注释标签
            return &#39;&#39;;
        }
        // 未识别的标签直接返回
        return C(&#39;TMPL_L_DELIM&#39;) . $tagStr .C(&#39;TMPL_R_DELIM&#39;); // 大哥居然还有你搞不定的这种呢,哈哈
    }

    /**
     * 模板变量解析,支持使用函数
     * 格式: {$varname|function1|function2=arg1,arg2}
     * @access public
     * @param string $varStr 变量数据
     * @return string
     * 模版变量 解析了
     */
    public function parseVar($varStr){
        $varStr     =   trim($varStr); // trim() 函数移除字符串两侧的空白字符或其他预定义字符。
        static $_varParseList = array(); // 仓库了
        //如果已经解析过该变量字串,则直接返回变量值
        if(isset($_varParseList[$varStr])) return $_varParseList[$varStr];
        // 直接返回了
        // 如果已经设置了 这个 变量了,然后就返回了
        $parseStr   =   &#39;&#39;; // 把解析 控制一下
        $varExists  =   true; // 变量是否存在
        if(!empty($varStr)){ // 如果 有 变量
            $varArray = explode(&#39;|&#39;,$varStr); // 这个进行了 数组分割
            //取得变量名称
            $var = array_shift($varArray); // 删除 并返回 第一数组元素
            if(&#39;Think.&#39; == substr($var,0,6)){ // Think.root
                // 所有以Think.打头的以特殊变量对待 无需模板赋值就可以输出
                $name = $this->parseThinkVar($var); // 就是解析完成的了
            }elseif( false !== strpos($var,&#39;.&#39;)) { // {$data.id}
                //支持 {$var.property}
                $vars = explode(&#39;.&#39;,$var);
                $var  =  array_shift($vars);// 踢出了这个
                switch(strtolower(C(&#39;TMPL_VAR_IDENTIFY&#39;))) {
                    case &#39;array&#39;: // 识别为数组 // 默认是这个了
                        $name = &#39;$&#39;.$var;
                        foreach ($vars as $key=>$val) // 可以多维数组
                            $name .= &#39;["&#39;.$val.&#39;"]&#39;;
                        break;
                    case &#39;obj&#39;:  // 识别为对象
                        $name = &#39;$&#39;.$var;
                        foreach ($vars as $key=>$val) // 多维对象
                            $name .= &#39;->&#39;.$val;
                        break;
                    default:  // 自动判断数组或对象 只支持二维
                        $name = &#39;is_array($&#39;.$var.&#39;)?$&#39;.$var.&#39;["&#39;.$vars[0].&#39;"]:$&#39;.$var.&#39;->&#39;.$vars[0];
                }
            }elseif(false !== strpos($var,&#39;[&#39;)) {
                //支持 {$var[&#39;key&#39;]} 方式输出数组  这种输出的方式不错
                $name = "$".$var;
                preg_match(&#39;/(.+?)\[(.+?)\]/is&#39;,$var,$match);
                $var = $match[1];
            }elseif(false !==strpos($var,&#39;:&#39;) && false ===strpos($var,&#39;(&#39;) && false ===strpos($var,&#39;::&#39;) && false ===strpos($var,&#39;?&#39;)){
                //支持 {$var:property} 方式输出对象的属性
                $vars = explode(&#39;:&#39;,$var); // 这个 表示是 对象
                $var  =  str_replace(&#39;:&#39;,&#39;->&#39;,$var);
                $name = "$".$var;
                $var  = $vars[0];
            }else {
                $name = "$$var";
            }
            //对变量使用函数
            if(count($varArray)>0)
                $name = $this->parseVarFunction($name,$varArray);
            $parseStr = &#39;&#39;; // 如果是个小函数了
        }
        $_varParseList[$varStr] = $parseStr; // 放到仓库里面 然后返回
        return $parseStr;
    }

    /**
     * 对模板变量使用函数
     * 格式 {$varname|function1|function2=arg1,arg2}
     * @access public
     * @param string $name 变量名
     * @param array $varArray  函数列表
     * @return string
     */
    public function parseVarFunction($name,$varArray){
        //对变量使用函数
        $length = count($varArray); // 这个里面的 这个了后面的
        //取得模板禁止使用函数列表   这个是函数列表 每一组的循环
        $template_deny_funs = explode(&#39;,&#39;,C(&#39;TMPL_DENY_FUNC_LIST&#39;)); //&#39;TMPL_DENY_FUNC_LIST&#39;   =>  &#39;echo,exit&#39;,    // 模板引擎禁用函数
        for($i=0;$i<$length ;$i++ ){
            $args = explode(&#39;=&#39;,$varArray[$i],2); // 进行 输入 参数的 过滤
            //模板函数过滤
            $fun = trim($args[0]); // 这个是函数了
            switch($fun) { // 这种的 自己东西
            case &#39;default&#39;:  // 特殊模板函数  哦哦想起来了这个,就是 那个  默认参数那个了 进行 三元运算符开始了
                $name = &#39;(isset(&#39;.$name.&#39;) && (&#39;.$name.&#39; !== ""))?(&#39;.$name.&#39;):&#39;.$args[1];
                break;
            default:  // 通用模板函数
                if(!in_array($fun,$template_deny_funs)){ // 在我们允许的函数 范围内
                    if(isset($args[1])){ // 这里的 意思是有参数了
                        if(strstr($args[1],&#39;###&#39;)){
                            $args[1] = str_replace(&#39;###&#39;,$name,$args[1]);
                            $name = "$fun($args[1])";
                        }else{
                            $name = "$fun($name,$args[1])"; // 第一个输入的就是参数了
                        }
                    }else if(!empty($args[0])){ // 这里的 那个 返回过去了,默认 就是把参数
                        $name = "$fun($name)";
                    }
                }
            }
        }
        return $name;
    }

    /**
     * 特殊模板变量解析
     * 格式 以 $Think. 打头的变量属于特殊模板变量
     * @access public
     * @param string $varStr  变量字符串
     * @return string
     * 这里的特殊模版 选择
     */
    public function parseThinkVar($varStr){
        $vars = explode(&#39;.&#39;,$varStr);// 这里的 那个 里面的就是 解析了
        $vars[1] = strtoupper(trim($vars[1]));// 这里是后面的 那个
        $parseStr = &#39;&#39;;// 解析后的字符串
        if(count($vars)>=3){ // 分两种的 开始
            $vars[2] = trim($vars[2]); // 三层的呢
            switch($vars[1]){
                case &#39;SERVER&#39;:
                    $parseStr = &#39;$_SERVER[\&#39;&#39;.strtoupper($vars[2]).&#39;\&#39;]&#39;;break;
                case &#39;GET&#39;:
                    $parseStr = &#39;$_GET[\&#39;&#39;.$vars[2].&#39;\&#39;]&#39;;break;
                case &#39;POST&#39;:
                    $parseStr = &#39;$_POST[\&#39;&#39;.$vars[2].&#39;\&#39;]&#39;;break;
                case &#39;COOKIE&#39;:
                    if(isset($vars[3])) {
                        $parseStr = &#39;$_COOKIE[\&#39;&#39;.$vars[2].&#39;\&#39;][\&#39;&#39;.$vars[3].&#39;\&#39;]&#39;;
                    }else{
                        $parseStr = &#39;cookie(\&#39;&#39;.$vars[2].&#39;\&#39;)&#39;;
                    }
                    break;
                case &#39;SESSION&#39;:
                    if(isset($vars[3])) {
                        $parseStr = &#39;$_SESSION[\&#39;&#39;.$vars[2].&#39;\&#39;][\&#39;&#39;.$vars[3].&#39;\&#39;]&#39;;
                    }else{
                        $parseStr = &#39;session(\&#39;&#39;.$vars[2].&#39;\&#39;)&#39;;
                    }
                    break;
                case &#39;ENV&#39;:
                    $parseStr = &#39;$_ENV[\&#39;&#39;.strtoupper($vars[2]).&#39;\&#39;]&#39;;break;
                case &#39;REQUEST&#39;:
                    $parseStr = &#39;$_REQUEST[\&#39;&#39;.$vars[2].&#39;\&#39;]&#39;;break;
                case &#39;CONST&#39;:
                    $parseStr = strtoupper($vars[2]);break;
                case &#39;LANG&#39;:
                    $parseStr = &#39;L("&#39;.$vars[2].&#39;")&#39;;break;
                case &#39;CONFIG&#39;:
                    if(isset($vars[3])) {
                        $vars[2] .= &#39;.&#39;.$vars[3];
                    }
                    $parseStr = &#39;C("&#39;.$vars[2].&#39;")&#39;;break;
                default:break;
            }
        }else if(count($vars)==2){ // 这种属性系统 参数了
            switch($vars[1]){
                case &#39;NOW&#39;:
                    $parseStr = "date(&#39;Y-m-d g:i a&#39;,time())";
                    break;
                case &#39;VERSION&#39;:
                    $parseStr = &#39;THINK_VERSION&#39;;
                    break;
                case &#39;TEMPLATE&#39;:
                    $parseStr = "&#39;".$this->templateFile."&#39;";//&#39;C("TEMPLATE_NAME")&#39;;
                    break;
                case &#39;LDELIM&#39;:
                    $parseStr = &#39;C("TMPL_L_DELIM")&#39;;
                    break;
                case &#39;RDELIM&#39;:
                    $parseStr = &#39;C("TMPL_R_DELIM")&#39;;
                    break;
                default:
                    if(defined($vars[1]))
                        $parseStr = $vars[1];
            }
        }
        return $parseStr;
    }

    /**
     * 加载公共模板并缓存 和当前模板在同一路径,否则使用相对路径
     * @access private
     * @param string $tmplPublicName  公共模板文件名
     * @param array $vars  要传递的变量列表
     * @return string
     */
    private function parseIncludeItem($tmplPublicName,$vars=array(),$extend){
        // 分析模板文件名并读取内容
        $parseStr = $this->parseTemplateName($tmplPublicName);
        // 这里的 外包了
        // 替换变量
        foreach ($vars as $key=>$val) {
            $parseStr = str_replace(&#39;[&#39;.$key.&#39;]&#39;,$val,$parseStr);
        }
        // // 这里的 外包了 进行替换了
        // 再次对包含文件进行模板分析
        return $this->parseInclude($parseStr,$extend);
        // 返回了
    }

    /**
     * 分析加载的模板文件并读取内容 支持多个模板文件读取
     * @access private
     * @param string $tmplPublicName  模板文件名
     * @return string
     */    
    private function parseTemplateName($templateName){
        if(substr($templateName,0,1)==&#39;$&#39;)
            //支持加载变量文件名
            $templateName = $this->get(substr($templateName,1));
        $array  =   explode(&#39;,&#39;,$templateName);
        $parseStr   =   &#39;&#39;; 
        foreach ($array as $templateName){
            if(empty($templateName)) continue;
            if(false === strpos($templateName,$this->config[&#39;template_suffix&#39;])) {
                // 解析规则为 模块@主题/控制器/操作
                $templateName   =   T($templateName);
            }
            // 获取模板文件内容
            $parseStr .= file_get_contents($templateName);
        }
        return $parseStr;
    }  // 各种神器的控制
}
相关文章
最新文章
热点推荐