thinkphp核心源碼注釋|Taglib.class.php

2024-05-05 00:04:38

字體：大中小

來源：轉載

供稿：網友

<?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;

    }

    // 無語返回

}