## 安装 通过`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'| 默认过滤方法 用于普通标签输出