thinkphp核心源码注释|Template.class.php
程序员文章站
2022-05-03 09:21:43
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;
} // 各种神器的控制
}
下一篇： 原生JS实现的双色球功能示例