ThinkPHP自定义模板标签详解
网志博客(w3note.com)
模板标签让网站前台开发更加快速和简单，这让本该由程序猿才能完成的工作，现在只要稍懂得HTM的人也能轻易做到，这也就是模板
标签的强大之处。接触过dedecms或者phpcms等内容管理系统的人都知道，cms的前台都是使用模板标签来调用数据，如列表，内容。来
看一个phpcms v9调用数据排行列表的标签:
1
{pc:content action=\"hits\" catid=\"6\" num=\"10\" order=\"views DESC\
2
{loop $data $r}
3
{$r[title]}4
{/loop}
5
{/pc}
说明：
pc大括号的的参数形式是:
{pc:content 参数名=”参数值” 参数名=”参数值” 参数名=”参数值”}
action:本参数的值表示为操作事件，模型类PC标签必须使用包含本参数，以说明要进行的操作。
catid：获取频道栏目的ID，和该栏目的数据
num:获取记录的条数，最后会被模板引擎处理成limit传送到处理函数中。
order：表示数据列表的排序方式
上面那段phpcms模板模签的功能就是获取ID等于6的栏目的10条数据，然后按照点击量排序。
不过上面的因为PHPCMS V9已经是一个成熟的CMS，它的模板标签是已经定义好的了，如\"pc\"，\"num\"等标签，我们只能通过阅读PHPCMS
V9的使用文档来学习如何调用，而不可以更改它的名称，而ThinkPHP只是一个框架，每个开发者都可以通过自定义模板标签来简化数据
的调用方式。
下面来自定义一个ThinkPHP模板标签，使它具体这样的功能：
1、 获取记录的条数，类似上面phpcms v9的\"num\"
2、对数据进行排序
准备工作：先找一个没有自定义模板标签的ThinkPHP的CMS或者博客程序安装，为了便于说明，我就使用wblog3.1.3_2.
注意，这是ThinkPHP3.1.3版本。
建立自定义标签库
打开W3note\\Lib\\，没有TagLib文件夹的，自己建立一个，然后在TagLib目录建立标签库文件，我就命名为TagLibLists.class.php。
自定义标签库的命名格式：\"TagLib\"+\"Lists\"+\".class.php\"，其中Lists\"是自定义的，第一个字母大写。
打开TagLibLists.class.php文件，写入如下代码：
01
02
class TagLibLists extends TagLib{
03
protected $tags = array(
04
05
'list' => array('attr' => 'limit,order','close' =>1)// attr 属性列表close 是否闭合（0 或者1 默认为1，表示闭合）
06
);
07
public function _list ($attr,$content){
08
09
$attr = $this->parseXmlAttr($attr);
10
$limit=$attr['limit'];//参数$limit，可通过模板传入参数值
11
$order=$attr['order'];//$order$limit，可通过模板传入参数值
12
$str='13
$str .= '$field=array(\"id\定义需要调用的字段
14
$str .=
'$_list_news=M(\"News\")->field($field)->limit('.$limit.')->order(\"'.$order.'\")->select();';//查询语句
15
$str .= 'foreach ($_list_news as $_list_value):';
16
$str .= 'extract($_list_value);';
17
$str .= '$url=U(\"read/\".$id);?>';//自定义文章生成路径$url
18
$str .= $content;
19
$str .='';
20
return $str;
21
}
22
}
注意：上面代码的第12行的'，查看缓存文件才发现,原来是'配置项目配置文件
在W3note\\Conf\\config.php配置文件加上下面三个配置项:
1
'TAGLIB_LOAD' => true,//加载标签库打开
2
'APP_AUTOLOAD_PATH' =>'@.TagLib',
3
'TAGLIB_BUILD_IN' =>'Cx,Lists',
说明：Cx为核心标签库名称，Lists为自定义标签库名称,不能弄错。
在模板上调用自定义标签
到这里我们已经建立起了自己的标签库，接下来就可以在模板上随心所欲地调用了。
1、调用最新文章
1
2
{$title}3
说明：
list 是上面自定义标签库数组$tags键名,因为设置为闭合形式，所以和
是成双成对出现的。
limit和order是前面标签库中定义的两个参数，通过它们可以在模板接受参数值，如上面给imit传递参数值\"9\"。
$title和$hits是标签库中根据需求选择的数据表字段
2、调用热点文章
1
2
{$title}[{$hits}]3
3、调用随机文章
1
2
{$title}3
说明：真没想到，在自定义模板标签里面还能解释php函数rand(),万万没想到，呵呵，这真是一个惊喜啊！
在调试中还发现，可以模板自定义签标中截取字符串：
1
2
{$title|msubstr=0,12,'utf-8'}3
通过前后对比，似乎ThinkPHP的自定义模板标签的调用比phpcms v9的标签更加方便简单，但功能还没有phpcms v9的灵活与强大，这需要
众多TPer的参与与完善。
小结：ThinkPHP自定义模板标签，可以在同一项目的不同模板里调用，方便简单，只是在定义标签库时要费点劲儿。
本文首发网志博客,欢迎转载！转载请注明本文地址,谢谢。