基本 API 使用
也可以通過下載原始碼並將其放在專案的目錄中來安裝它。但是,使用 composer 有很多好處。
require '/path/to/lib/Twig/Autoloader.php';
Twig_Autoloader::register();
$loader = new Twig_Loader_Filesystem('/path/to/templates');
$options = array(
'strict_variables' => false,
'debug' => false,
'cache'=> false
);
$twig = new Twig_Environment($loader, $options);
在建立新的 Twig_Environment
例項時,你可以傳遞一個選項陣列作為建構函式的第二個引數。以下是可用選項的列表:
- debug( 布林值,預設
false
)
設定為 true 時,生成的模板具有
__toString()
方法,可用於顯示生成的節點。
- charset( 字串,預設
utf-8
)
模板使用的字符集。
- base_template_class( 字串,預設
Twig_Template
)
用於生成模板的基本模板類。
- 快取( 字串或
false
,預設false
)
儲存已編譯模板的絕對路徑,或 false 以禁用快取(這是預設值)。
- auto_reload( boolean ,預設繼承自 debug )
使用 Twig 進行開發時,每當原始碼更改時重新編譯模板都很有用。如果沒有為 auto_reload 選項提供值,則將根據除錯值自動確定該值。
- strict_variables( 布林值,預設
false
)
如果設定為 false,Twig 將默默地忽略無效變數(變數和/或不存在的屬性/方法),並用空值替換它們。設定為 true 時,Twig 會丟擲異常。
- autoescape( string 或 boolean ,default
true
)
如果設定為 true,則預設情況下將為所有模板啟用 HTML 自動轉義。
從 Twig 1.8 開始,你可以設定要使用的轉義策略(html,js,false 禁用)。
從 Twig 1.9 開始,你可以設定要使用的轉義策略(css,url,html_attr 或帶有模板
filename
的 PHP 回撥,並且必須返回要使用的轉義策略 - 回撥不能是要避免的函式名稱與內建逃逸策略的碰撞)。從 Twig 1.17 開始,檔名轉義策略根據模板副檔名確定用於模板的轉義策略(此策略在執行時不會產生任何開銷,因為自動轉義是在編譯時完成的。)
- 優化( 整數,預設
-1
)
一個標誌,指示要應用的優化:
set to -1 to enabled all optimalizations
set o 0 to disable all optimalitazations
還可以編譯和安裝 Twig PHP 擴充套件(用 C 編寫),PHP 包將自動利用它來優化一些常見例程。