Twig模板引擎的用法

1.注释

{# 这是注释内容 #}

{# 
这是多行注释
 #}

2.变量与控制

变量

可以直接使用变量 {{ value }}
也可以为对象或数组 {{ obj.key }} 、 {{ arr[0] }} 或 {{ arr[key] }}
也可以调用对象的方法 {{ obj.getName }}
也可以传参调用方法 {{ obj.getName(a,b) }}

当模版中使用{ { foo.bar }}时，PHP会做如下判断来检测对应变量的值：

检测foo是否是数组，并且bar是一个有效的KEY
如果foo为对象，则检测bar是否为有效的属性
如果foo为对象，但bar不是一个有效的属性，则检测bar是否为有效方法
如果foo为对象，但bar不是一个有效的方法，则检测getBar是否为有效方法
如果foo为对象，但getBar不是有效方法，则检测isBar是否为有效方法
如果没有，则返回null

其他：
设置默认值 { { 变量|default('默认值') }} 如果‘变量’为null，则输出‘默认值’
声明变量1 {% set 变量名 = 变量值 %}

{# 声明变量 foo #}
{% set foo = 'bar' %}
{# 输出变量 foo #}
{{ foo }}
{# 最终输出结果 bar #}

声明变量2 {% set 变量名 %} 变量值 {% endset %}

{% set foo %}
    <div id="pagination">
        ...
    </div>
{% endset %}
{# 实际为 foo =  <div id="pagination"> ...</div> #}

选择

{% if 判断条件 %} 输出内容 {% endif %}：通过条件选择输出内容

//isShow为true或者false
{% if isShow %}
    <p>isShow为true的时候显示本内容</p>
{% endif %}

//多个选择条件（比较符下一节进行介绍）
{% if temperature > 18 and temperature < 27 %}
    <p>It's a nice day for a walk in the park.</p>
{% endif %}

//多重条件选择示例
{% if kenny.sick %}
    Kenny is sick.
{% elseif kenny.dead %}
    You killed Kenny! You bastard!!!
{% else %}
    Kenny looks okay --- so far
{% endif %}

注意：
在判断条件里面，一些特殊数据格式的布尔值：
空字符串、数字0、空数组和null 的值都为 false；
只有空格的字符串、不为空的数组和对象都为 true；

循环

{% for 数组项 in 数组 %} 循环体 {% endfor %} ：循环或遍历数组

{# 循环输出users数据集里的所有user的username熟悉 #}
{% for user in users %}
    <li>{{ user.username|e }}</li>
{% endfor %}

{# 还可以利用'..'来输出0到10 和 a到z等 #}
{% for i in 0..10 %}
    * {{ i }}
{% endfor %}
{% for letter in 'a'..'z' %}
    * {{ letter }}
{% endfor %}

循环体内部(自带的)变量：
loop.index 循环的次数（从1开始）
loop.index0 循环的次数（从0开始）
loop.revindex 循环剩余次数（最小值为1）
loop.revindex0 循环剩余次数（最小值为0）
loop.first 当第一次循环的时候返回true
loop.last 当最后一次循环的时候返回true
loop.length 循环的总数
loop.parent 被循环的数组

3.运算和表达式

运算符

运算符号的优先级(高→低):
== != < > >= <= + - ~ * / // % ** | [] . .. and or not in is b-and b-or b-xor
其中，
~ 是用于连接两个字符串，类似于PHP的‘.’
// 是整除
** 是乘方，类似于^
and or not 分别为并、或、非，分别相当于&&、||、!
b-and b-or b-xor 分别是位与、位或和位异或
- 是减法以及去除空白的简写用法，如 { {- 数据 }} => 去除左边的空白、{ { 数据 -}} => 去除右边的空白、{ {- 数据 -}} => 去除两边的空白

(未完待续)

表达式

4.函数与过滤

函数

参数命名

过滤器

转义

{% autoescape %} xxx {% endautoescape %}：将字符串安全地处理成合法的指定数据

{% autoescape %}
    无论自动转义启用与否，你都可以使用 autoescape 标签来标记模板的一部分进行转义或不转义
{% endautoescape %}

空白控制 spaceless

{% spaceless %} xxx {% endspaceless %}：减少 HTML 片段中的空格和换行

{% spaceless %} 
<div>
    <b>a b c</b>
</div>
{% endspaceless %}

{# 实际输出：<div><b>a b c</b></div> #}

Twig模板引擎的用法