thinkphp核心源码注释|Template.class.php
程序员文章站
2024-01-13 23:36:22
config['taglib_begin'];// 标签开启
$end = $this->config['ta...
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')){// 如果开启了短标签, // 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['file']; unset($array['file']); $content = str_replace($matches[0][$i],$this->parseIncludeItem($file,$array,$extend),$content); } } return $content; } // 就是个解析了 // 解析模板中的extend标签 protected function parseExtend($content) { $begin = $this->config['taglib_begin']; $end = $this->config['taglib_end']; // 读取模板中的继承标签 $find = preg_match('/'.$begin.'extend\s(.+?)\s*?\/'.$end.'/is',$content,$matches); if($find) { //替换extend标签 $content = str_replace($matches[0],'',$content); // 记录页面中的block标签 preg_replace_callback('/'.$begin.'block\sname=[\'"](.+?)[\'"]\s*?'.$end.'(.*?)'.$begin.'\/block'.$end.'/is', array($this, 'parseBlock'),$content); // 读取继承模板 $array = $this->parseXmlAttrs($matches[1]); $content = $this->parseTemplateName($array['name']); $content = $this->parseInclude($content, false); //对继承模板中的include进行分析 // 替换block标签 $content = $this->replaceBlock($content); }else{ $content = preg_replace_callback('/'.$begin.'block\sname=[\'"](.+?)[\'"]\s*?'.$end.'(.*?)'.$begin.'\/block'.$end.'/is', function($match){return stripslashes($match[2]);}, $content); } return $content; }// 就是个解析了 // 基本的思路,就是,先替换系统标签,然后,进行正则选择,然后对选择后的文件 // 进行替换 完成。 /** * 分析XML属性 * @access private * @param string $attrs XML属性字符串 * @return array */ private function parseXmlAttrs($attrs) { $xml = ''; $xml = simplexml_load_string($xml); if(!$xml) E(L('_XML_TAG_ERROR_')); $xml = (array)($xml->tag->attributes()); $array = array_change_key_case($xml['@attributes']); 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)=='') return ''; //$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 = '') { if(is_array($name)){ $content = $name[2]; $name = $name[1]; } $this->block[$name] = $content; return ''; }// 就是个解析了 /** * 替换继承模板中的block标签 * @access private * @param string $content 模板内容 * @return string */ private function replaceBlock($content){ static $parse = 0; $begin = $this->config['taglib_begin']; $end = $this->config['taglib_end']; $reg = '/('.$begin.'block\sname=[\'"](.+?)[\'"]\s*?'.$end.')(.*?)'.$begin.'\/block'.$end.'/is'; if(is_string($content)){ // 这个是个字符串 do{ $content = preg_replace_callback($reg, array($this, 'replaceBlock'), $content); } while ($parse && $parse--); return $content; } elseif(is_array($content)){ // 居然是个 数组 if(preg_match('/'.$begin.'block\sname=[\'"](.+?)[\'"]\s*?'.$end.'/is', $content[3])){ //存在嵌套,进一步解析 $parse = 1; $content[3] = preg_replace_callback($reg, array($this, 'replaceBlock'), "{$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('/'.$this->config['taglib_begin'].'taglib\s(.+?)(\s*?)\/'.$this->config['taglib_end'].'\W/is',$content,$matches); if($find) { //替换TagLib标签 $content = str_replace($matches[0],'',$content); //解析TagLib标签 $array = $this->parseXmlAttrs($matches[1]); $this->tagLib = explode(',',$array['name']); } 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['taglib_begin'];// 标签开始 位置标记 $end = $this->config['taglib_end'];// 标签结束 位置标记 if(strpos($tagLib,'\\')){// 如果存在 标签库命名 说白了,就是 有了 // 支持指定标签库的命名空间 $className = $tagLib;// 转换了 存储了一下 $tagLib = substr($tagLib,strrpos($tagLib,'\\')+1); }else{ $className = 'Think\\Template\TagLib\\'.ucwords($tagLib); }// 找到要解析的标签库的名称 $tLib = \Think\Think::instance($className);// 实例化对应的类名 $that = $this; foreach ($tLib->getTags() as $name=>$val){ // 对全部的标签进行解析处理 $tags = array($name); if(isset($val['alias'])) {// 别名设置 $tags = explode(',',$val['alias']); $tags[] = $name; } $level = isset($val['level'])?$val['level']:1; $closeTag = isset($val['close'])?$val['close']:true; foreach ($tags as $tag){ // 对这些标签 进行更多的处理 $parseTag = !$hide? $tagLib.':'.$tag: $tag;// 实际要解析的标签名称 if(!method_exists($tLib,'_'.$tag)) {// 这些各种各样的别名解析方式 // 别名可以无需定义解析方法 $tag = $name; } $n1 = empty($val['attr'])?'(\s*?)':'\s([^'.$end.']*)'; $this->tempVar = array($tagLib, $tag); if (!$closeTag){ // 非闭合标签 $patterns = '/'.$begin.$parseTag.$n1.'\/(\s*?)'.$end.'/is'; $content = preg_replace_callback($patterns, function($matches) use($tLib,$tag,$that){ return $that->parseXmlTag($tLib,$tag,$matches[1],$matches[2]); },$content); }else{ // 闭合标签 $patterns = '/'.$begin.$parseTag.$n1.$end.'(.*?)'.$begin.'\/'.$parseTag.'(\s*?)'.$end.'/is'; 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('magic_quotes_sybase')) $attr = str_replace('\"','\'',$attr); // 把单引号 $parse = '_'.$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('$' == $flag && '.' != $flag2 && '(' != $flag2){ //解析模板变量 格式 {$varName} // 类似于这种 return $this->parseVar($name); // 或者这种 普通的 标签之类的 }elseif('-' == $flag || '+'== $flag){ // 输出计算 +a return ''; }elseif(':' == $flag){ // 输出某个函数的结果 这个找到了 {:U()} return ''; }elseif('~' == $flag){ // 执行某个函数 {} return '';// 这里作为普通函数进行输出一下 }elseif(substr($tagStr,0,2)=='//' || (substr($tagStr,0,2)=='/*' && substr(rtrim($tagStr),-2)=='*/')){ //注释标签 // 如果这种 普通的标签 注释标签 return ''; } // 未识别的标签直接返回 return C('TMPL_L_DELIM') . $tagStr .C('TMPL_R_DELIM'); // 大哥居然还有你搞不定的这种呢,哈哈 } /** * 模板变量解析,支持使用函数 * 格式: {$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 = ''; // 把解析 控制一下 $varExists = true; // 变量是否存在 if(!empty($varStr)){ // 如果 有 变量 $varArray = explode('|',$varStr); // 这个进行了 数组分割 //取得变量名称 $var = array_shift($varArray); // 删除 并返回 第一数组元素 if('Think.' == substr($var,0,6)){ // Think.root // 所有以Think.打头的以特殊变量对待 无需模板赋值就可以输出 $name = $this->parseThinkVar($var); // 就是解析完成的了 }elseif( false !== strpos($var,'.')) { // {$data.id} //支持 {$var.property} $vars = explode('.',$var); $var = array_shift($vars);// 踢出了这个 switch(strtolower(C('TMPL_VAR_IDENTIFY'))) { case 'array': // 识别为数组 // 默认是这个了 $name = '$'.$var; foreach ($vars as $key=>$val) // 可以多维数组 $name .= '["'.$val.'"]'; break; case 'obj': // 识别为对象 $name = '$'.$var; foreach ($vars as $key=>$val) // 多维对象 $name .= '->'.$val; break; default: // 自动判断数组或对象 只支持二维 $name = 'is_array($'.$var.')?$'.$var.'["'.$vars[0].'"]:$'.$var.'->'.$vars[0]; } }elseif(false !== strpos($var,'[')) { //支持 {$var['key']} 方式输出数组 这种输出的方式不错 $name = "$".$var; preg_match('/(.+?)\[(.+?)\]/is',$var,$match); $var = $match[1]; }elseif(false !==strpos($var,':') && false ===strpos($var,'(') && false ===strpos($var,'::') && false ===strpos($var,'?')){ //支持 {$var:property} 方式输出对象的属性 $vars = explode(':',$var); // 这个 表示是 对象 $var = str_replace(':','->',$var); $name = "$".$var; $var = $vars[0]; }else { $name = "$$var"; } //对变量使用函数 if(count($varArray)>0) $name = $this->parseVarFunction($name,$varArray); $parseStr = ''; // 如果是个小函数了 } $_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(',',C('TMPL_DENY_FUNC_LIST')); //'TMPL_DENY_FUNC_LIST' => 'echo,exit', // 模板引擎禁用函数 for($i=0;$i<$length ;$i++ ){ $args = explode('=',$varArray[$i],2); // 进行 输入 参数的 过滤 //模板函数过滤 $fun = trim($args[0]); // 这个是函数了 switch($fun) { // 这种的 自己东西 case 'default': // 特殊模板函数 哦哦想起来了这个,就是 那个 默认参数那个了 进行 三元运算符开始了 $name = '(isset('.$name.') && ('.$name.' !== ""))?('.$name.'):'.$args[1]; break; default: // 通用模板函数 if(!in_array($fun,$template_deny_funs)){ // 在我们允许的函数 范围内 if(isset($args[1])){ // 这里的 意思是有参数了 if(strstr($args[1],'###')){ $args[1] = str_replace('###',$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('.',$varStr);// 这里的 那个 里面的就是 解析了 $vars[1] = strtoupper(trim($vars[1]));// 这里是后面的 那个 $parseStr = '';// 解析后的字符串 if(count($vars)>=3){ // 分两种的 开始 $vars[2] = trim($vars[2]); // 三层的呢 switch($vars[1]){ case 'SERVER': $parseStr = '$_SERVER[\''.strtoupper($vars[2]).'\']';break; case 'GET': $parseStr = '$_GET[\''.$vars[2].'\']';break; case 'POST': $parseStr = '$_POST[\''.$vars[2].'\']';break; case 'COOKIE': if(isset($vars[3])) { $parseStr = '$_COOKIE[\''.$vars[2].'\'][\''.$vars[3].'\']'; }else{ $parseStr = 'cookie(\''.$vars[2].'\')'; } break; case 'SESSION': if(isset($vars[3])) { $parseStr = '$_SESSION[\''.$vars[2].'\'][\''.$vars[3].'\']'; }else{ $parseStr = 'session(\''.$vars[2].'\')'; } break; case 'ENV': $parseStr = '$_ENV[\''.strtoupper($vars[2]).'\']';break; case 'REQUEST': $parseStr = '$_REQUEST[\''.$vars[2].'\']';break; case 'CONST': $parseStr = strtoupper($vars[2]);break; case 'LANG': $parseStr = 'L("'.$vars[2].'")';break; case 'CONFIG': if(isset($vars[3])) { $vars[2] .= '.'.$vars[3]; } $parseStr = 'C("'.$vars[2].'")';break; default:break; } }else if(count($vars)==2){ // 这种属性系统 参数了 switch($vars[1]){ case 'NOW': $parseStr = "date('Y-m-d g:i a',time())"; break; case 'VERSION': $parseStr = 'THINK_VERSION'; break; case 'TEMPLATE': $parseStr = "'".$this->templateFile."'";//'C("TEMPLATE_NAME")'; break; case 'LDELIM': $parseStr = 'C("TMPL_L_DELIM")'; break; case 'RDELIM': $parseStr = 'C("TMPL_R_DELIM")'; 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('['.$key.']',$val,$parseStr); } // // 这里的 外包了 进行替换了 // 再次对包含文件进行模板分析 return $this->parseInclude($parseStr,$extend); // 返回了 } /** * 分析加载的模板文件并读取内容 支持多个模板文件读取 * @access private * @param string $tmplPublicName 模板文件名 * @return string */ private function parseTemplateName($templateName){ if(substr($templateName,0,1)=='$') //支持加载变量文件名 $templateName = $this->get(substr($templateName,1)); $array = explode(',',$templateName); $parseStr = ''; foreach ($array as $templateName){ if(empty($templateName)) continue; if(false === strpos($templateName,$this->config['template_suffix'])) { // 解析规则为 模块@主题/控制器/操作 $templateName = T($templateName); } // 获取模板文件内容 $parseStr .= file_get_contents($templateName); } return $parseStr; } // 各种神器的控制 }
上一篇: SQL中常用字符串函数