轉載地址：http://pengbotao.cn/twig-template-language.html

Twig中有兩種定界符{% ... %} 和 {{ ... }} ， 前一種用來執行語句，比如for循環、IF判斷、過濾等操作，后一種模版中用來顯示變量。

Twig常用用法

可用符號

== != < > >= <= + - ~ * / // % ** | [] . .. and or not in is b-and b-or b-xor
部分符號的含義如下

~：連接兩字符串，相當于 PHP 中的點號
//：整除
**：乘方，相當于 PHP 中的 ^
b-and、b-or、b-xor：按位與、按位或、按位異或
-：減法以及去除空白的簡寫用法，如 {{- 數據 }} => 去除左邊的空白、{{ 數據 -}} => 去除右邊的空白、{{- 數據 -}} => 去除兩邊的空白

注釋

{# This is Twig Comment #}

變量

foo 為PHP賦值變量， 則模版中可以使用 {{ foo }}
如果該變量為數組或者對象，則可以使用 {{ foo.bar }}來表示，也可以直接調用類中的方法，如 {{ foo.getName }} 或當有參數傳遞時使用 {{ foo.getName(p1, p2, p3) }}

當模版中使用{{ foo.bar }}時，PHP會做如下判斷來檢測對應變量的值：
1. 檢測foo是否是數組，并且bar是一個有效的KEY
2. 如果foo為對象，則檢測bar是否為有效的屬性
3. 如果foo為對象，但bar不是一個有效的屬性，則檢測bar是否為有效方法
4. 如果foo為對象，但bar不是一個有效的方法，則檢測getBar是否為有效方法
5. 如果foo為對象，但getBar不是有效方法，則檢測isBar是否為有效方法
6. 如果沒有，則返回null

當foo為數組時，模版也可以這樣使用：{{ foo['bar'] }}

變量未定義默認值設置：
{{ var|default('var is not defined') }}

可使用 {% set 變量名=變量值 %} 聲明變量，也可寫成 {% set 變量名 %} 變量值 {% endset %}

PHP 中非關聯數組被映射成 [元素1, 元素2, ...]，關聯數組則被映射成 {鍵1: 值1, 鍵2: 值2, ...}

數組遍歷

-- 按數組value遍歷：

1 2 3

{% for value in foo %} ????{{ value }} {% endfor %}

-- 按數組key遍歷：

1 2 3

{% for key in foo|keys %} ????{{ key }} {% endfor %}

-- 按key，value遍歷

1 2 3

{% for key, value in foo %} ????{{ key}}:{{value }} {% endfor %}

-- 如果 foo 非數組，還可以使用else語句，如：

1 2 3 4 5

{% for key, value in foo %} ????{{ key}}:{{value }} {% else %}? ????foo is Not a Array {% endfor %}

-- 也可以直接帶條件，遍歷二維數組時比較有用，可用value.field來判斷：

1 2 3

{% for key, value in foo if value == 1%} ????{{ key}}:{{value }} {% endfor %}

循環體內部變量：
loop.index 循環的次數（從1開始）
loop.index0 循環的次數（從0開始）
loop.revindex 循環剩余次數（最小值為1）
loop.revindex0 循環剩余次數（最小值為0）
loop.first 當第一次循環的時候返回true
loop.last 當最后一次循環的時候返回true
loop.length 循環的總數
loop.parent 被循環的數組

條件語句

-- 需要使用 or 和 and 代替 ||、&&

1 2 3

{% if a == '1' or b == '2' %} a = 1 or b = 2 {% endif %}

-- 判斷變量是否定義

1 2 3

{% if var is not defined %} ????{# do something #} {% endif %}

-- 是否為NULL

1 2 3

{% if var is null %} ????{# do something #} {% endif %}

-- 是否為false

1 2 3

{% if var is sameas(false) %} ????{# do something %} {% endif %}

解析定界符

1 2 3 4 5 6 7 8 9

{{ '{{' }} {% raw %} ????<ul> ????{% for item in seq %} ????????<li>{{ item }}</li> ????{% endfor %} ????</ul> {% endraw %}

控制結構

{% if aaa %} xxx {% elseif bbb %} yyy {% else %} zzz：判斷語句
{% for %} xxx {% endfor %}：迭代變量
{% do %}：沒什么其他含義，{% do 1+2 %} 等同于 {{ 1+2 }}
{% flush %}：刷新輸出緩沖，等同于 flush
{% include %}：包含模板
{% extends %}：擴展模板
{% embed %} xxx {% endembed %}：包含模板并擴展該模板的內容，相當于 include 和 extends 的結合體
{% use %}：包含模板，近似于多重繼承
{% from aaa import bbb as ccc %}：從指定模板導入宏并設置別名
{% macro %} xxx {% endmacro %}：定義宏以便多次調用，與定義 PHP 函數無異
{% sandbox %} {% include xxx %} {% endsandbox %}：對導入的模板指定沙箱模式，只對 include 語句有效，只在沙箱模式已開啟的情況下生效
{% block xxx %} 或 {% block %} xxx {% endblock %}：定義代碼塊或覆蓋代碼塊
{% set xxx %} 或 {% set %} xxx {% endset %}：在模板內定義變量
{% filter %} xxx {% endfilter %}：多行過濾器
{% spaceless %} xxx {% endspaceless %}：去除 HTML 片段中的空格
{% autoescape %} xxx {% endautoescape %}：將字符串安全地處理成合法的指定數據
{% verbatim %} xxx {% endverbatim %}：阻止模板引擎的編譯，是 raw 的新名字

內建過濾器

過濾器用來修飾數據，各過濾器可以用豎線分隔進行鏈式調用，用括號傳遞參數

也可以將過濾器當成單獨的函數來用，形式如下：

1 2 3

{% filter 過濾器名 %} 待處理的數據 {% endfilter %}

batch：將數組按指定的個數分割成更小的數組，可選的第二個參數用來在元素不夠的情況下進行填充。如 {{ [1, 2, 3, 4, 5]|batch(2, 'NoItem') }} => [[1, 2], [3, 4], [5, 'NoItem']]
date_modify：修改時間，常與 date 聯用。如 {{ ''|date_modify('+3 days')|date('Y-m-d') }} => 將當前時間加3天后顯示
default：當所修飾的數據不存在或為空時，提供默認值。如 {{ ''|default('Ruchee') }} => 'Ruchee'
escape：將字符串安全地處理成合法的指定數據，可簡寫為 e，支持多種轉換模式，默認模式為 html，其他可選模式有 html_attr、js、css、url
first：返回數組的第一個元素或字符串的第一個字符。如 {{ {a: 1, b: 2, c: 3}|first }} => 1
last：返回數組的最后一個元素或字符串的最后一個字符。如 {{ {a: 1, b: 2, c: 3}|last }} => 3
replace：替換一個字符串中的指定內容。如 {{ '%s1 love %s2'|replace({'%s1': 'Ruchee', '%s2': 'Vim'}) }} => 'Ruchee love Vim'
raw：讓數據在 autoescape 過濾器里失效

借用自PHP自帶函數的過濾器

abs：取絕對值
nl2br：將字符串里的 \n 替換成 <br/>
join：將數組的各個元素按指定分隔符組成字符串
sort：對數組排序
trim：去除字符串首尾的指定字符，默認為空格
date：格式化時間，可處理與 strtotime 兼容的字符串，或 DateTime/DateInterval 的實例，可選的第二個參數用于指定時區，如果所修飾的數據為空則默認為當前時間
reverse：反轉一個數組或字符串，在 array_reverse 的基礎上增加了對字符串的處理
slice：截取數組或字符串的一部分，在 array_slice 的基礎上增加了對字符串的處理
keys：將數組的全部鍵名提取成一個數組，等同于 array_keys
merge：合并兩數組，近似于 array_merge 。如 {{ 數組1|merge(數組2) }}
length：返回數組元素的個數或字符串的長度，等同于 count 和 strlen 的結合體
capitalize：將字符串的首字母大寫，等同于 ucfirst
title：將字符串中每個單詞的首字母大寫，等同于 ucwords
lower：將字符串所有字母全部變成小寫，等同于 strtolower
upper：將字符串所有字母全部變成大寫，等同于 strtoupper
split：將字符串分割成數組，等同于 str_split
striptags：去除字符串中的 HTML/PHP 標記，等同于 strip_tags
url_encode：編碼鏈接字符串，等同于 urlencode
json_encode：編碼 JSON 格式，等同于 json_encode
format：格式化一個字符串，近似于 printf 。如 {{ 'My name is %s, and I love %s'|format('Ruchee', 'Vim') }} => 'My name is Ruchee, and I love Vim'
number_format：格式化數值，等同于 number_format
convert_encoding：編碼轉換，第一個參數指定轉換后的編碼，第二個參數指定轉換前的編碼，近似于 iconv

內建函數

even：是否為偶數
odd：是否為奇數
empty：是否為空
null：是否為 null
defined：是否已定義
sameas：目標變量與指定值是否指向的是內存中的同一個地址，使用形式 if 變量值 is sameas(指定值)
divisibleby：目標數值是否能夠被指定值整除，使用形式 if 目標數值 divisibleby(指定值)，其中指定值不能為 0
iterable：目標變量是否是數組或者是否可迭代，使用形式 if 變量值 is iterable
attribute：動態獲取變量屬性值，兩種使用形式為 attribute(數組, '元素名') 和 attribute(對象, '方法名', 可選參數)
block：重復引用指定代碼塊，如 {{ block('title') }}
constant：從字符串或對象取得常量值
cycle：循環顯示一個數組的元素，調用形式為 cycle(數組, 一個循環變量)
date：格式化時間
dump：在開啟調試模式的情況下顯示詳細的變量信息，等同于 var_dump
include：包含其他模板文件
parent：在覆蓋代碼片段時用于引用父片段的內容
random：制造一個隨機數
range：返回一個指定區間的數組，可指定步長，Twig 使用 .. 作為其簡用法，等同于 range
template_from_string：根據字符串加載模板

總結

以上是生活随笔為你收集整理的Twig模板语言入门的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。