建议开发者将自定义标签库请放置应用目录中,请勿放在框架系统目录内,以免使用Composer更新框架时导致自定义标签库的丢失
下面是一个Demo标签库的示例:
<?php
namespace app\common\taglib;
use think\template\TagLib;
class Demo extends TagLib{
/**
* 定义标签列表
*/
protected $tags = [
// 标签定义: attr 属性列表 close 是否闭合(0 或者1 默认1) alias 标签别名 level 嵌套层次
'close' => ['attr' => 'time,format', 'close' => 0], //闭合标签,默认为不闭合
'open' => ['attr' => 'name,type', 'close' => 1],
];
/**
* 这是一个闭合标签的简单演示
*/
public function tagClose($tag)
{
$format = empty($tag['format']) ? 'Y-m-d H:i:s' : $tag['format'];
$time = empty($tag['time']) ? time() : $tag['time'];
$parse = '<?php ';
$parse .= 'echo date("' . $format . '",' . $time . ');';
$parse .= ' ?>';
return $parse;
}
/**
* 这是一个非闭合标签的简单演示
*/
public function tagOpen($tag, $content)
{
$type = empty($tag['type']) ? 0 : 1; // 这个type目的是为了区分类型,一般来源是数据库
$name = $tag['name']; // name是必填项,这里不做判断了
$parse = '<?php ';
$parse .= '$test_arr=[[1,3,5,7,9],[2,4,6,8,10]];'; // 这里是模拟数据
$parse .= '$__LIST__ = $test_arr[' . $type . '];';
$parse .= ' ?>';
$parse .= '{volist name="__LIST__" id="' . $name . '"}';
$parse .= $content;
$parse .= '{/volist}';
return $parse;
}
}
这时候我们的控制器继承Controller
,在配置参数中配置:
'template' => [
// 模板引擎类型 支持 php think 支持扩展
'type' => 'Think',
// 模板路径
'view_path' => '',
// 模板后缀
'view_suffix' => '.html',
// 预先加载的标签库
'taglib_pre_load' => 'app\common\taglib\Demo',
],
我们就可以在控制器中对模版赋值:
$this->assign('demo_time',time());
在模版中调用我们已经预先加载的标签:
<h1>开放标签</h1>
{demo:open time='$demo_time'/}
<hr>
<h1>闭合标签</h1>
{demo:close name='demo_name'}
{$key}=>{$demo_name}<br>
{/demo:close}
<br>
{demo:close name='demo_name' type='1'}
{$key}=>{$demo_name}<br>
{/demo:close}