安装配置
最后更新于：2022-04-02 07:24:59
## 安装
通过`composer`安装即可
~~~php
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);
```
如果在ThinkPHP`6.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|object|'', 为空时自动识别
default_filter| 'htmlentities'| 默认过滤方法 用于普通标签输出
';