## 介紹
`think-template`是一個(gè)基于PHP`5.6+`實(shí)現(xiàn)的編譯型模板引擎,主要特性包括:
- 支持XML標(biāo)簽庫(kù)和普通標(biāo)簽的混合定義;
- 支持直接使用PHP代碼書(shū)寫(xiě);
- 支持文件包含;
- 支持多級(jí)標(biāo)簽嵌套;
- 支持布局模板功能;
- 一次編譯多次運(yùn)行,編譯和運(yùn)行效率非常高;
- 模板文件和布局模板更新,自動(dòng)更新模板緩存;
- 系統(tǒng)變量無(wú)需賦值直接輸出;
- 支持多維數(shù)組的快速輸出;
- 支持模板變量的默認(rèn)值;
- 支持頁(yè)面代碼去除Html空白;
- 支持變量組合調(diào)節(jié)器和格式化功能;
- 允許定義模板禁用函數(shù)和禁用PHP語(yǔ)法;
- 通過(guò)標(biāo)簽庫(kù)方式擴(kuò)展;
功能特性和ThinkPHP`5.1`內(nèi)置的模板引擎基本一致,適用于沒(méi)有使用`ThinkPHP`框架但希望找一個(gè)高性能的編譯型模板引擎的情況。
## 安裝
通過(guò)`composer`直接安裝即可
~~~php
composer require topthink/think-template
~~~
## 用法示例
在根目錄下創(chuàng)建`index.php`入口文件測(cè)試:
~~~php
<?php
namespace think;
require __DIR__.'/vendor/autoload.php';
// 設(shè)置模板引擎參數(shù)
$config = [
// 模板文件目錄
'view_path' => './template/',
// 模板編譯緩存目錄(可寫(xiě))
'cache_path' => './runtime/',
// 模板文件后綴
'view_suffix' => 'html',
];
$template = new Template($config);
// 模板變量賦值
$template->assign('name','thinkphp');
// 讀取模板文件渲染輸出
$template->fetch('index');
~~~
更多的模板引擎參數(shù)可以參考
`fetch`方法必須指定模板文件名(不需要后綴和路徑),上面的代碼對(duì)應(yīng)的模板文件位于 `./template/index.html`。
然后就可以在模板文件中輸出模板變量
~~~
Hello,{$name}!
~~~
執(zhí)行入口文件應(yīng)該會(huì)看到輸出
```
Hello,thinkphp!
```
變量輸出的定界符支持自定義,例如:
```
$config = [
// 模板文件目錄
'view_path' => './template/',
// 模板編譯緩存目錄(可寫(xiě))
'cache_path' => './runtime/',
// 模板文件后綴
'view_suffix' => 'html',
// 模板引擎普通標(biāo)簽開(kāi)始標(biāo)記
'tpl_begin' => '{',
// 模板引擎普通標(biāo)簽結(jié)束標(biāo)記
'tpl_end' > '}',
];
```
如果要批量給模板變量賦值,可以用
```
// 批量賦值
$template->assign([
'name' => 'thinkphp',
'foo' => 'bar',
]);
```
支持直接渲染內(nèi)容輸出,不需要定義模板文件
```
$template = new Template($config);
// 模板變量賦值
$template->assign('name','thinkphp');
// 渲染內(nèi)容輸出
$content = 'Hello,{$name}!';
$template->display($content);
```
所有的模板變量默認(rèn)輸出都會(huì)自動(dòng)進(jìn)行轉(zhuǎn)義處理,以避免`XSS`攻擊的可能性。如果你不需要進(jìn)行任何的轉(zhuǎn)義,可以使用`|raw`保持原樣不做轉(zhuǎn)義輸出(例如輸出HTML內(nèi)容的時(shí)候需要)。
```
Hello,{$name|raw}!
```
## 數(shù)組和對(duì)象輸出
如果需要在模板中輸出數(shù)組,可以使用
```
{$item.name}
// 或者
{$item['name']}
```
要輸出對(duì)象的屬性,可以使用
```
{$object->name}
```
也可以直接調(diào)用對(duì)象的常量或者方法
~~~cmd
常量:{$object::CONST_NAME}
方法:{$object->method()}
~~~
支持函數(shù)
```
{$name|strtolower|strip_tags}
```
## 系統(tǒng)變量輸出
如果需要輸出系統(tǒng)變量,可以不需要賦值給模板變量然后輸出,可以直接在模板文件中輸出系統(tǒng)變量,例如:
~~~
{$Think.server.script_name} // 輸出$_SERVER['SCRIPT_NAME']變量
{$Think.session.user_id} // 輸出$_SESSION['user_id']變量
{$Think.get.page} // 輸出$_GET['page']變量
{$Think.cookie.name} // 輸出$_COOKIE['name']變量
~~~
支持輸出 `$_SERVER`、`$_ENV`、 `$_POST`、 `$_GET`、 `$_REQUEST`、`$_SESSION`和 `$_COOKIE`變量。
如果系統(tǒng)常量直接使用
~~~
{$Think.PHP_VERSION}
~~~
## 運(yùn)算符
我們可以對(duì)模板輸出使用運(yùn)算符,包括如下支持。
| 運(yùn)算符 | 使用示例 |
|-----|-----|
| `+` | `{$a+$b}` |
| `-` | `{$a-$b}` |
| `*` | `{$a*$b}` |
| `/` | `{$a/$b}` |
| `%` | `{$a%$b}` |
| `++` | `{$a++}` 或 `{++$a}` |
| `--` | `{$a--}` 或` {--$a}` |
| 綜合運(yùn)算 | `{$a+$b*10+$c} `|
在使用運(yùn)算符的時(shí)候,不再支持前面提到的函數(shù)過(guò)濾用法,例如:
~~~
{$user.score+10} //正確的
{$user['score']+10} //正確的
{$user['score']*$user['level']} //正確的
{$user['score']|myFun*10} //錯(cuò)誤的
{$user['score']+myFun($user['level'])} //正確的
~~~
## 三元運(yùn)算
模板可以支持三元運(yùn)算符,例如:
~~~
{$status? '正常' : '錯(cuò)誤'}
{$info['status']? $info['msg'] : $info['error']}
{$info.status? $info.msg : $info.error }
~~~
還支持如下的寫(xiě)法:
~~~
{$name ?? '默認(rèn)值'}
~~~
## 原樣輸出
可以使用`literal`標(biāo)簽來(lái)防止模板標(biāo)簽被解析,例如:
~~~cmd
{literal}
Hello,{$name}!
{/literal}
~~~
上面的`{$name}`標(biāo)簽被`literal`標(biāo)簽包含,因此并不會(huì)被模板引擎解析,而是保持原樣輸出。
`literal`標(biāo)簽還可以用于頁(yè)面的JS代碼外層,確保JS代碼中的某些用法和模板引擎不產(chǎn)生混淆。
總之,所有可能和內(nèi)置模板引擎的解析規(guī)則沖突的地方都可以使用`literal`標(biāo)簽處理。
## 模板注釋
模板支持注釋功能,該注釋文字在最終頁(yè)面不會(huì)顯示,僅供模板制作人員參考和識(shí)別。
### 單行注釋
格式:
~~~cmd
{/* 注釋內(nèi)容 */ } 或 {// 注釋內(nèi)容 }
~~~
例如:
~~~cmd
{// 這是模板注釋內(nèi)容 }
~~~
> 注意`{`和注釋標(biāo)記之間不能有空格。
### 多行注釋
支持多行注釋?zhuān)纾?
~~~cmd
{/* 這是模板
注釋內(nèi)容*/ }
~~~
模板注釋支持多行,模板注釋在生成編譯緩存文件后會(huì)自動(dòng)刪除,這一點(diǎn)和Html的注釋不同。
更多的關(guān)于模板引擎以及標(biāo)簽的詳細(xì)用法參考[ThinkPHP5.1手冊(cè)的模板章節(jié)](http://www.imay365.com/manual/thinkphp5_1/354069)。
- 值得升級(jí)到5.1的18個(gè)理由
- 5.1.7版本新特性
- JSON字段類(lèi)型在ORM中的使用
- 文件下載響應(yīng)對(duì)象
- 教你使用5.1的數(shù)組對(duì)象查詢(xún)
- 模型三大利器之一:搜索器
- 在ThinkPHP中使用Yaconf
- 掌握命令行的表格輸出
- 5.1.25查詢(xún)參數(shù)綁定的改進(jìn)
- ThinkPHP安全規(guī)范指引
- 巧用數(shù)據(jù)集的排序功能實(shí)現(xiàn)統(tǒng)計(jì)排序
- think-orm ——基于5.1的獨(dú)立ORM庫(kù)
- think-template——基于ThinkPHP的獨(dú)立模板引擎
- ThinkPHP5.1.26版本發(fā)布——修正版本,包含安全更新
- ThinkPHP5.0和3.2再發(fā)安全更新
- 官宣:ThinkPHP發(fā)布首個(gè)LTS版本
- 你真的了解Db類(lèi)和模型的正確使用姿勢(shì)么?
- 如何更有效的記錄和管理日志
- 模型三大利器之二:修改器
- ThinkPHP5.1.28版本發(fā)布——修正上一版本問(wèn)題,改進(jìn)關(guān)聯(lián)查詢(xún)
- 模型三大利器之三:獲取器
- API版本控制的幾種思路
- ThinkPHP5.2第一個(gè)Beta版本發(fā)布測(cè)試
- 讓你少犯錯(cuò)的數(shù)據(jù)查詢(xún)基本原則
- ThinkPHP發(fā)布5.1.29版本——常規(guī)更新
- 這15個(gè)好習(xí)慣讓你更容易升級(jí)到5.2
- 如何有效提高ThinkPHP的應(yīng)用性能
- 讓你提高開(kāi)發(fā)效率的查詢(xún)技巧
- 模型關(guān)聯(lián)查詢(xún)不完全指南
- 5.2發(fā)布Beta2版本——統(tǒng)一和精簡(jiǎn)大量用法
- ThinkPHP發(fā)布5.1.30版本——支持微秒時(shí)間字段寫(xiě)入
- ThinkPHP的數(shù)據(jù)緩存使用
- ThinkPHP5.2安裝及入口文件
- ThinkPHP榮獲2018 年度最受歡迎中國(guó)開(kāi)源開(kāi)發(fā)框架第1名
- 5.1路由使用心得技巧
- ThinkPHP5.*版本發(fā)布安全更新
- ThinkPHP項(xiàng)目及代碼規(guī)范指北
- 5.2版本的設(shè)計(jì)規(guī)范指導(dǎo)
- ThinkPHP5.1.32版本發(fā)布——圣誕快樂(lè)
- 利用Trait特性給模型增加樂(lè)觀鎖功能
- 5.2數(shù)據(jù)庫(kù)和模型的變化(摘要)
- ThinkPHP模板引擎實(shí)現(xiàn)和常見(jiàn)問(wèn)題
- ThinkPHP5.0.24版本發(fā)布——安全更新
- 不忘初心,方得始終——ThinkPHP十三周年報(bào)告
- ThinkPHP5+相關(guān)資源匯總
- 異步社區(qū)ThinkPHP周年慶專(zhuān)享優(yōu)惠活動(dòng)
- 5.2路由的調(diào)整和改進(jìn)
- ThinkPHP發(fā)布5.1.33版本——包含安全更新
- ThinkPHP擴(kuò)展開(kāi)發(fā)指南
- ThinkPHP發(fā)布5.2Beta3版本
- ThinkPHP發(fā)布5.1.34版本——喜迎新年
- ThinkPHP發(fā)布5.2RC1版本
- ThinkPHP發(fā)布5.1.35版本——常規(guī)更新
- 5.2配置類(lèi)的調(diào)整
- 5.2時(shí)間查詢(xún)的改進(jìn)和優(yōu)化
- 5.2RC版本升級(jí)不完全指導(dǎo)(僅供學(xué)習(xí)參考)
- ThinkPHP5.2版本正式變更為6.0版本
- ThinkPHP百度云云虛擬主機(jī)專(zhuān)享免費(fèi)活動(dòng)
- 事件系統(tǒng)以及查詢(xún)事件、模型事件的使用
- ThinkPHP6.0RC2版本發(fā)布——架構(gòu)升級(jí)、精簡(jiǎn)核心
- ThinkPHP5.1.36LTS版本發(fā)布——常規(guī)更新
- 新版Session和Cookie設(shè)計(jì)變化
- ThinkPHP5.1.37版本發(fā)布——常規(guī)更新
- ThinkPHP6.0RC3版本發(fā)布——細(xì)節(jié)完善,體驗(yàn)優(yōu)化
- 6.0中間件使用詳解
- Composer各大廠商鏡像地址
- ThinkPHP6.0發(fā)布計(jì)劃公告
- 「ThinkPHP開(kāi)發(fā)者周刊」招募志愿者
- ThinkPHP6.0日志變化
- ThinkPHP5.1.38版本發(fā)布——常規(guī)更新
- ThinkPHP6.0RC4版本發(fā)布——ORM獨(dú)立,日志多通道支持
- ThinkORM2.0開(kāi)發(fā)指南上線
- ThinkPHP6.0RC5版本發(fā)布——多應(yīng)用模式獨(dú)立,中間件機(jī)制調(diào)整
- ThinkPHP6.0版本發(fā)布——程序員節(jié)福利
- ThinkPHP5.1.39LTS版本發(fā)布——常規(guī)更新
- ThinkPHP6.0.1版本發(fā)布——圣誕快樂(lè)!
- 回顧2019,展望2020!
- ThinkPHPV6.0.2版本發(fā)布——2020新春快樂(lè)!
- 周年福利系列:Swoole合作優(yōu)惠
- 億速云成為T(mén)hinkPHPV6.0獨(dú)家贊助發(fā)布商??
- 新冠疫情工具和限免資源專(zhuān)題(保持更新中)
- 周年福利系列:創(chuàng)宇信用認(rèn)證合作優(yōu)惠
- 周年福利系列:碼云企業(yè)版限時(shí)10%優(yōu)惠
- 周年福利系列:想天短說(shuō)抵現(xiàn)優(yōu)惠
- think-swoole直播:從零開(kāi)始掌握swoole開(kāi)發(fā)
- 周年福利系列:B2C開(kāi)源電商ShopXO授權(quán)8折優(yōu)惠
- 周年福利系列:LayuiAdmin 永久授權(quán)限時(shí)優(yōu)惠
- ThinkPHP資源導(dǎo)航站上線——構(gòu)建生態(tài) 服務(wù)未來(lái)
- ThinkPHP官方技術(shù)支持服務(wù)和應(yīng)用服務(wù)市場(chǎng)上線公測(cè)
- ThinkPHP市場(chǎng)精選——推廣基本要素
- ThinkPHP市場(chǎng)精選——客服聊天專(zhuān)題
- ThinkPHPV6.0.3版本發(fā)布——端午安康
- ThinkPHP開(kāi)發(fā)者扶持計(jì)劃
- 6.0.3版本關(guān)鍵更新及升級(jí)事項(xiàng)
- 「ThinkPHP開(kāi)發(fā)者周刊」改版重啟
- ThinkPHP市場(chǎng)精選——企業(yè)建站專(zhuān)題
- ThinkPHP 提供統(tǒng)一API接口服務(wù)
- ThinkPHP市場(chǎng)精選——直播電商專(zhuān)題
- ThinkAPI服務(wù)SDK發(fā)布
- 官方服務(wù)市場(chǎng)啟用獨(dú)立子域名
- ThinkPHP市場(chǎng)精選——刷臉支付專(zhuān)題
- ThinkAPI推出會(huì)員服務(wù)計(jì)劃
- ThinkPHPV6.0.4版本發(fā)布——中秋國(guó)慶雙節(jié)快樂(lè)
- ThinkPHPV5.1.40版本發(fā)布——常規(guī)更新
- 1024程序員節(jié)福利走一波
- ThinkPHP V6.0.5版本發(fā)布——兼容Composer2.0
- 知識(shí)圖譜應(yīng)用場(chǎng)景——源論技術(shù)沙龍
- ThinkPHP5.*版本改進(jìn)Composer2.0的兼容
- 官方市場(chǎng)雙十一精選推薦
- 技術(shù)人做產(chǎn)品有機(jī)會(huì)么(文末送課程)
- 本周秒殺——古德云售后獲客營(yíng)銷(xiāo)系統(tǒng)
- ThinkAPI服務(wù)更新——支持接口分組和PHP版本依賴(lài)調(diào)整
- PHP8新特性盤(pán)點(diǎn)
- PHP8新特性系列:構(gòu)造器屬性提升使用及注意事項(xiàng)
- ThinkPHP2021新年寄語(yǔ)
- ThinkPHP V6.0.6&V5.1.41版本發(fā)布——兼容PHP8.0
- PHP如何更優(yōu)雅地調(diào)用API接口
- ThinkPHP V6.0.7發(fā)布——修正版本
- ThinkAPI服務(wù)更新——IP白名單
- 最新版ThinkORM對(duì)于時(shí)間字段的調(diào)整
- ThinkAPI短信接口正式上線
- ThinkPHP V6.0.8版本發(fā)布——多環(huán)境變量配置支持
- 頂想云寫(xiě)作服務(wù)開(kāi)啟第一次公測(cè)
- ThinkSSL上線——官方SSL/TLS證書(shū)服務(wù)
- MDBootstrap國(guó)內(nèi)用戶(hù)福利——ThinkPHP官方市場(chǎng)首發(fā)
- ThinkPHP V6.0.9版本發(fā)布——常規(guī)更新
- ThinkORM功能盤(pán)點(diǎn)——虛擬模型
- 全面支持主流GIT版本庫(kù)——云寫(xiě)作服務(wù)第二次公測(cè)
- 云寫(xiě)作服務(wù)私有化部署方案之:版本庫(kù)私有化
- 看云雙十一活動(dòng)
- ThinkPHP V6.0.10LTS發(fā)布——兼容PHP8.1
- ThinkPHP V6.0.12發(fā)布——命令行兼容8.1
- 頂想云知識(shí)管理上線公測(cè)——構(gòu)建企業(yè)文檔中心和知識(shí)庫(kù)
- 頂想云上線——助力生態(tài)數(shù)字化建設(shè)
- 618活動(dòng)進(jìn)行中——官方市場(chǎng)迎來(lái)一波更新
- 頂想云知識(shí)管理正式上線——看云文檔啟動(dòng)遷移服務(wù)
- ThinkPHP V6.0.13發(fā)布——常規(guī)更新
- 頂想云網(wǎng)站助理服務(wù)上線——構(gòu)建產(chǎn)品支持服務(wù)
- ThinkPHP發(fā)布6.1.0&6.0.14版本——安全更新
- ThinkPHP新版社區(qū)上線試運(yùn)營(yíng)
- ThinkAPI上架人臉核身接口——助力網(wǎng)站實(shí)名認(rèn)證
- 辭舊迎新——舊版社區(qū)停止注冊(cè)及發(fā)帖
- ThinkPHP6.1.2版本發(fā)布——兼容PHP8.2
