thinkphp3.0 自定义标签

在thinkphp3.0之前,TP的模板引擎是基于xml标签来为TP模板引擎进行扩展,3.0之后TP的模板引擎可以到类中用数组的形式进行定义。要想让TP的模板功能更加的强大,那你就得学会扩展TP的自定义标签功能

TP3.0下面自定义标签步骤如下:

•  文件名的规范;

  TagLibModelTag.class.php(TagLib加上你的标签名称,首字母记得要大写)

• 目录所在;

  是自定义的标签我将他发到了thinkphp/Extend/COM/TagLib目录下面(为了防止在项目中多处引用该目录,可以在配置文件中直接加载这个目录

  'APP_AUTOLOAD_PATH'=>'@.TagLib,COM.TagLib'

• 代码的编写

  我以我开发的从model中调用函数返回数据为例

  class TagLibModelTag extends TagLib {protected $tags = array(// 标签定义： attr 属性列表 close 是否闭合（0 或者1 默认1） alias 标签别名 level 嵌套层次'select'=>array('attr'=>'name,function,outputhtml,key,item,params','level' => 3));/** * 调用数据模型中的函数 * outputhtml为是否输出html代码(如果标签写在模板文件中就要输出到模板文件中, * 如果为某个模板的模板或内容保存的则要直接输出) */public function _select($attr, $content){$tag = $this->parseXmlAttr($attr, 'select');$outputHtml = !empty($tag['outputhtml']) ? intval($tag['outputhtml']) : 0;if( $tag['name'] && $tag['function'] ){$item = !empty($tag['item']) ? $tag['item'] : 'stnts';$key = !empty($tag['key']) ? $tag['key'] : 'key';$paramStr = !empty($tag['params'])?addslashes($tag['params']):'';            if( $outputHtml ){            $tplFileName = LIBRARY_PATH."COM/STNTS/TagLib/modelTag.tpl.php";            if( file_exists($tplFileName) ){            $tpl = file_get_contents($tplFileName);            $parsestr = str_replace(array('{modelname}','{modelfunction}','{paramStr}','{key}','{val}','{content}'),              array($tag['name'],$tag['function'],$paramStr,$key,$item,$content),               $tpl);            }            }else{            $_model = DE($tag['name']);            if( method_exists($_model, $tag['function']) ){            if( $tag['params'] ){$params = explode("|", $tag['params']);foreach( $params as $paramStr ){$paramArray = explode("::", $paramStr);$map[$paramArray[0]] = $paramArray[1];}}            $find = preg_match_all('/'.C('taglib_begin')."\\$".$item.'\.(\w*?)'.C('taglib_end').'/is',$content,$matches,PREG_SET_ORDER);            if( $find ){            $_result = $_model->$tag['function']($map);            foreach ( $_result as $key=>$val ){            $tempCotnent = $content;            foreach ( $matches as $m ){            $tempCotnent = str_replace($m[0], $val[$m[1]], $tempCotnent);            }            $parsestr .= $tempCotnent;            }            }            }            }}return $parsestr;}}

  注意事项：

  • 一定要定义$tags属性,里面要定义key和对应的值, 标签定义： attr 属性列表 close 是否闭合（0 或者1 默认1） alias 标签别名 level 嵌套层次
  • 定义方法:方法名称要和$tags中的key对应,并在key的前面加上下划线.列如我在$tags中定义了一个key的值为:mylist。那么定义的方法名称为:_mysql($attr,$content)
  • 在函数返回值的时候不用到{}标签还要记得<?php ?>之间的闭合问题.在我的这个类中要返回php代码的,已有直接返回html的,所有有时候可以将php返回的模板放到同一个目录中方便自己修改;如下：

    <?php$_model =  DE('{modelname}');$_modelFunction = '{modelfunction}';$_paramStr =stripslashes ('{paramStr}');$_key = '{key}';$_val='{val}';if( method_exists($_model,$_modelFunction) ):if( strrpos($_paramStr,"|") || strrpos( $_paramStr,"::") ):$params = explode("|", $_paramStr);foreach ( $params as $paramV ):if( strrpos( $paramV,"::") ):$param = explode("::", $paramV);$map[$param[0]] = $param[1];endif;endforeach;endif;$_result = $_model->$_modelFunction($map);foreach ( $_result as $$_key=> $$_val ):?>{content}<?php endforeach;endif;?>

    采用替换的形式来生成对应的php代码,在返回html代码的时候要用正则来解析你的内容如：

    $find = preg_match_all('/'.C('taglib_begin')."\\$".$item.'\.(\w*?)'.C('taglib_end').'/is',$content,$matches,PREG_SET_ORDER);

  • 一定要有返回结果的字符串
• 在你的模板中定义

  {%taglib name="modelTag"/%}{%modelTag:select name="new" function="getData" params="where::id=3"%}{%$stnts.title%}{%$stnts.title%}
  {%$stnts.intro%}
  {%/modelTag:select%}

  注意事项：
  • 一定要加入{%taglib name="modelTag"/%}。name为你的标签类名称

  • {%modelTag:select name="new" function="getData" params="where::id=3"%}…{%/modelTag:select%}

    {%modelTag:select%}中modelTag为你的标签类名称,select为你在modelTag类中定义$tags的key，后面的属性都为在$tags中定义的属性,请一一对应,否则将无妨得到对应的值

文档我上传到了空间下载地址