## 安裝
通過`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'| 默認過濾方法 用于普通標簽輸出