[李景山php]thinkphp核心源码注释|Taglib.class.php

<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK IT ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006-2014 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------
namespace Think\Template;
/**
* ThinkPHP标签库TagLib解析基类
* 这个基础类，好像是跟那个差不多呢
*/
class TagLib {

/**
* 标签库定义XML文件
* @var string
* @access protected
*/
protected $xml      = ''; // 保存的文件
protected $tags     = array();// 标签定义
/**
* 标签库名称
* @var string
* @access protected
*/
protected $tagLib   ='';// 标签库名称

/**
* 标签库标签列表
* @var string
* @access protected
*/
protected $tagList  = array();

/**
* 标签库分析数组
* @var string
* @access protected
*/
protected $parse    = array();

/**
* 标签库是否有效
* @var string
* @access protected
*/
protected $valid    = false;

/**
* 当前模板对象
* @var object
* @access protected
*/
protected $tpl;

protected $comparison = array(' nheq '=>' !== ',' heq '=>' === ',' neq '=>' != ',' eq '=>' == ',' egt '=>' >= ',' gt '=>' > ',' elt '=>' <= ',' lt '=>' < ');
// 对标签的一定 处理，标签 很重要
/**
* 架构函数
* @access public
*/
public function __construct() {
$this->tagLib  = strtolower(substr(get_class($this),6));// 如果这样写的话，对于基类 一点意义也没有呢
// substr get_class($this) TagLib
$this->tpl     = \Think\Think::instance('Think\\Template'); // 实例化模版了
}// 初始化了 这里的  taglib 其实是没什么的了 ，
// tpl 就是个 new 一下 Think\Template 了

/**
* TagLib标签属性分析 返回标签属性数组
* @access public
* @param string $tagStr 标签内容
* @return array
*/
public function parseXmlAttr($attr,$tag) {
//XML解析安全过滤
$attr   =   str_replace('&','___', $attr);// 你这个替换是弄啥赖，哈哈
$xml    =   '<tpl><tag '.$attr.' /></tpl>';
$xml    =   simplexml_load_string($xml); // 返回类 SimpleXMLElement 的一个对象，该对象的属性包含 XML 文档中的数据。如果失败，则返回 false。
if(!$xml) {
E(L('_XML_TAG_ERROR_').' : '.$attr);
}// 如果没有获取到 对应
$xml    =   (array)($xml->tag->attributes());// 获取到对应的属性数组
if(isset($xml['@attributes'])){
$array  =   array_change_key_case($xml['@attributes']);
if($array) { // 如果已经 包含 了数据
$tag    =   strtolower($tag);// 获取了 这里的 小写
if(!isset($this->tags[$tag])){
// 检测是否存在别名定义
foreach($this->tags as $key=>$val){
if(isset($val['alias']) && in_array($tag,explode(',',$val['alias']))){
$item  =   $val;
break;
}
}
}else{
$item  =   $this->tags[$tag];
}
$attrs  = explode(',',$item['attr']);
if(isset($item['must'])){
$must   =   explode(',',$item['must']);
}else{
$must   =   array();
}
foreach($attrs as $name) {
if( isset($array[$name])) {
$array[$name] = str_replace('___','&',$array[$name]);
}elseif(false !== array_search($name,$must)){
E(L('_PARAM_ERROR_').':'.$name);
}
}
return $array;
}
}else{
return array();// 返回 空字符串
}
}// 总结，反正没看明白了，不知道里面放的一些什么了

/**
* 解析条件表达式
* @access public
* @param string $condition 表达式标签内容
* @return array
*/
public function parseCondition($condition) {
$condition = str_ireplace(array_keys($this->comparison),array_values($this->comparison),$condition);
$condition = preg_replace('/\$(\w+):(\w+)\s/is','$\\1->\\2 ',$condition);
switch(strtolower(C('TMPL_VAR_IDENTIFY'))) {
case 'array': // 识别为数组
$condition  =   preg_replace('/\$(\w+)\.(\w+)\s/is','$\\1["\\2"] ',$condition);
break;
case 'obj':  // 识别为对象
$condition  =   preg_replace('/\$(\w+)\.(\w+)\s/is','$\\1->\\2 ',$condition);
break;
default:  // 自动判断数组或对象 只支持二维
$condition  =   preg_replace('/\$(\w+)\.(\w+)\s/is','(is_array($\\1)?$\\1["\\2"]:$\\1->\\2) ',$condition);
}
if(false !== strpos($condition, '$Think'))
$condition      =   preg_replace_callback('/(\$Think.*?)\s/is', array($this, 'parseThinkVar'), $condition);
return $condition;
}// 条件的 组合

/**
* 自动识别构建变量
* @access public
* @param string $name 变量描述
* @return string
* 大哥啊，你也不给个例子呢
*/
public function autoBuildVar($name) {
if('Think.' == substr($name,0,6)){
// 特殊变量
return $this->parseThinkVar($name);
}elseif(strpos($name,'.')) {
$vars = explode('.',$name);
$var  =  array_shift($vars);
switch(strtolower(C('TMPL_VAR_IDENTIFY'))) {
case 'array': // 识别为数组
$name = '$'.$var;
foreach ($vars as $key=>$val){
if(0===strpos($val,'$')) {
$name .= '["{'.$val.'}"]';
}else{
$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(strpos($name,':')){
// 额外的对象方式支持
$name   =   '$'.str_replace(':','->',$name);
}elseif(!defined($name)) {
$name = '$'.$name;
}
return $name;
} // 嗯嗯，想起来了，以前在 Tempalte 里面解析过呢

/**
* 用于标签属性里面的特殊模板变量解析
* 格式 以 Think. 打头的变量属于特殊模板变量
* @access public
* @param string $varStr  变量字符串
* @return string
* 这里的在 Template 里面是一样的
*/
public function parseThinkVar($varStr){
if(is_array($varStr)){//用于正则替换回调函数
$varStr = $varStr[1];
}
$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[\''.$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].'\']';
}elseif(C('COOKIE_PREFIX')){
$parseStr = '$_COOKIE[\''.C('COOKIE_PREFIX').$vars[2].'\']';
}else{
$parseStr = '$_COOKIE[\''.$vars[2].'\']';
}
break;
case 'SESSION':
if(isset($vars[3])) {
$parseStr = '$_SESSION[\''.$vars[2].'\'][\''.$vars[3].'\']';
}elseif(C('SESSION_PREFIX')){
$parseStr = '$_SESSION[\''.C('SESSION_PREFIX').'\'][\''.$vars[2].'\']';
}else{
$parseStr = '$_SESSION[\''.$vars[2].'\']';
}
break;
case 'ENV':         $parseStr = '$_ENV[\''.$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':    $parseStr = 'C("'.$vars[2].'")';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 = '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;
}// 这里以前用过的

// 获取标签定义
public function getTags(){
return $this->tags;
}
// 无语返回
}