基本 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 ,defaulttrue

如果設定為 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 安裝指南

還可以編譯和安裝 Twig PHP 擴充套件(用 C 編寫),PHP 包將自動利用它來優化一些常見例程。