安装
通过composer安装即可 composer require topthink/think-template
配置
可以在实例化think\Template类的时候传入模板引擎的配置参数
// 设置模板引擎参数
$config = [
'view_path' => './template/',
'cache_path' => './runtime/',
'view_suffix' => 'html',
];
$template = new \think\Template($config);
在实例化之后也可以调用config方法完成配置
$config = [
'view_path' => './template/',
'cache_path' => './runtime/',
'view_suffix' => 'html',
];
$template = new \think\Template();
$template->config($config);
如果在ThinkPHP6.0+中使用的话，只需要在view.php配置文件中进行模板配置定义即可。
// 模板引擎配置
return [
// 模板引擎类型使用ThinkTemplate
'type' => 'Think',
// 默认模板渲染规则 1 解析为小写+下划线 2 全部转换小写 3 保持操作方法
'auto_rule' => 1,
// 模板目录名
'view_dir_name' => 'view',
// 模板后缀
'view_suffix' => 'html',
];
系统会自动定位模板目录，你无需配置view_path参数。
配置参数
支持如下配置参数：
| 参数名 | 默认值 | 描述 |
|---|---|---|
| view_path | 空 | 模板路径 |
| view_suffix | 'html' | 默认模板文件后缀 |
| view_depr | DIRECTORY_SEPARATOR | 模板文件分隔符 |
| cache_path | 空 | 模板缓存目录 |
| cache_suffix | 'php' | 默认模板缓存后缀 |
| tpl_deny_func_list | 'echo,exit' | 模板引擎禁用函数 |
| tpl_deny_php | false | 默认模板引擎是否禁用PHP原生代码 |
| tpl_begin | '{' | 模板引擎普通标签开始标记 |
| tpl_end | '}' | 模板引擎普通标签结束标记 |
| strip_space | false | 是否去除模板文件里面的HTML空格与换行 |
| tpl_cache | true | 是否开启模板编译缓存,设为false则每次都会重新编译 |
| compile_type | 'file' | 模板编译类型 |
| cache_prefix | '' | 模板缓存前缀标识，可以动态改变 |
| cache_time | 0 | 模板缓存有效期 0 为永久，(以数字为值，单位:秒) |
| layout_on | false | 布局模板开关 |
| layout_name | 'layout' | 布局模板入口文件 |
| layout_item | '{CONTENT}' | 布局模板的内容替换标识 |
| taglib_begin | '{' | 标签库标签开始标记 |
| taglib_end | '}' | 标签库标签结束标记 |
| taglib_load | true | 是否使用内置标签库之外的其它标签库，默认自动检测 |
| taglib_build_in | 'cx' | 内置标签库名称(标签使用不必指定标签库名称),以逗号分隔 注意解析顺序 |
| taglib_pre_load | '' | 需要额外加载的标签库(须指定标签库名称)，多个以逗号分隔 |
| display_cache | false | 模板渲染缓存 |
| cache_id | '' | 模板缓存ID |
| tpl_replace_string | [] | |
| tpl_var_identify | 'array' | .语法变量识别，array |
| default_filter | 'htmlentities' | 默认过滤方法 用于普通标签输出 |