...
{{ parent() }}
{% endblock %}
```
> [扩展](https://twig.sensiolabs.org/doc/2.x/tags/extends.html)标签的文档页面描述了更高级的功能，如块嵌套、范围、动态继承和条件继承。
>
> Twig在使用标签的帮助下也支持多个继承，即所谓的水平重用。这是在常规模板中几乎不需要的高级特性。
### HTML转义(HTML Escaping)
当从模板生成HTML时，总是有一个风险，变量将包括影响生成HTML的字符。有两种方法:手动转义每个变量，或者默认情况下自动转义。
Twig支持这两种，自动转义是默认启用的。
自动转义策略可以通过[autoescape](https://twig.sensiolabs.org/doc/2.x/api.html#environment-options)选项和默认的html来配置。
#### 使用手动转义
如果手动转移已启用，如果需要转义变量这是您的责任。转义什么？任何你不信任的变量。
通过escape或e过滤器将变量通过管道进行转义:
```markup
{{ user.username|e }}
```
默认情况下，escape过滤器使用html策略，但是根据转义上下文，您可能想要显式地使用其他可用策略:
```markup
{{ user.username|e('js') }}
{{ user.username|e('css') }}
{{ user.username|e('url') }}
{{ user.username|e('html_attr') }}
```
#### 使用自动转义
无论是否启用了自动转义，您都可以通过使用自动转义标记来标记一个模板的一个片段:
```markup
{% autoescape %}
Everything will be automatically escaped in this block (using the HTML strategy)
{% endautoescape %}
```
默认情况下，自动转义使用html转义策略。如果在其他上下文中输出变量，则需要使用适当的转义策略显式地转义它们:
```markup
{% autoescape 'js' %}
Everything will be automatically escaped in this block (using the JS strategy)
{% endautoescape %}
```
### 转义(Escaping)
有时需要或甚至有必要让Twig忽略它可能作为变量或块来处理的部分。例如，如果使用默认的语法，并且希望在模板中使用{ {作为原始字符串，而不是启动变量，则必须使用技巧。
最简单的方法是使用一个变量表达式输出变量分隔符({ {):
```markup
{{ '{{' }}
```
### 宏(Macros)
宏可以与常规编程语言中的函数相比较。它们是有用的，可以重用经常使用的HTML片段不重复自己。
宏通过[宏](https://twig.sensiolabs.org/doc/2.x/tags/macro.html)标签定义。这里有一个小的例子(后来被称为forms.html)呈现一个表单元素:
```markup
{% macro input(name, value, type, size) %}
{% endmacro %}
```
宏可以在任何模板中定义，在使用之前需要通过[导入](https://twig.sensiolabs.org/doc/2.x/tags/import.html)标签“导入”:
```markup
{% import "forms.html" as forms %}
{{ forms.input('username') }}
```
或者，您可以从模板从模板导入单个宏名称，通过[from](https://twig.sensiolabs.org/doc/2.x/tags/from.html)标签到当前名称空间，并可选地将它们别名为:
```markup
{% from 'forms.html' import input as input_field %}
Username
{{ input_field('username') }}
Password
{{ input_field('password', '', 'password') }}
```
如果在宏调用中没有提供，还可以为宏参数定义一个默认值:
```markup
{% macro input(name, value = "", type = "text", size = 20) %}
{% endmacro %}
```
如果将额外的位置参数传递给宏调用，它们将以特殊的varargs变量作为值列表结束。
### 表达式(Expressions)
Twig 允许表达式无处不在。这些工作与普通PHP非常相似，即使您不使用PHP，您也应该感到满意。
> 操作符优先级如下，优先级低的操作符首先列出:b-and, b-xor, b-or, or, and, ==, !=, <, >, >=, <=, in, matches, starts with, ends with, .., +, -, \~, \*, /, //, %, is, \*\*, |, \[], and .:
```markup
{% set greeting = 'Hello ' %}
{% set name = 'Fabien' %}
{{ greeting ~ name|lower }} {# Hello fabien #}
{# use parenthesis to change precedence #}
{{ (greeting ~ name)|lower }} {# hello fabien #}
```
#### 文字(Literals)
最简单的表达式形式是文字。文本是PHP类型的表示形式，如字符串、数字和数组。以下文字存在:
`“Hello World”`:两个双引号和单引号之间的所有内容都是字符串。每当在模板中需要字符串时，它们都是有用的(例如，函数调用、过滤器或只是扩展或包含模板)。一个字符串可以包含一个分隔符，如果它前面是一个反斜杠(\\)，比如'It\\'s good'。如果字符串包含反斜杠(例如。 'c:\Program Files')转移它变成双倍的(例如:'c:\Program Files')。
* `42 / 42.23`:整数和浮点数是通过写下数字来创建的。如果一个点代表一个浮点数，否则一个整数。
* `[" foo "，" bar "]`:数组的定义是由一个逗号分隔的表达式序列，并用方括号(\[])包装。
* `{“foo”:“bar”}`:散列是由一个由逗号分隔的键和值的列表定义的，并用花括号({ })结束。
```markup
{# keys as string #}
{ 'foo': 'foo', 'bar': 'bar' }
{# keys as names (equivalent to the previous hash) #}
{ foo: 'foo', bar: 'bar' }
{# keys as integer #}
{ 2: 'foo', 4: 'bar' }
{# keys as expressions (the expression must be enclosed into parentheses) #}
{ (1 + 1): 'foo', (a ~ 'b'): 'bar' }
```
* `true / false`:true表示真值，false表示假值。
* `null`: null表示没有特定的值。这是当变量不存在时返回的值。none是null的别名。
数组和散列可以嵌套:
```markup
{% set foo = [1, {"foo": "bar"}] %}
```
> 使用双引号或单引号字符串对性能没有影响，但是字符串插值只在双引号的字符串中得到支持。
#### 数学运算(Math)
Twig允许你计算值。这在模板中很少有用，但是为了完整性而存在。支持以下操作符:
* +:将两个对象加在一起(操作数被编码为数字)。{ 1 + 1 }是2。
* \-:减去第一个数字的第二个数字。{ 3 - 2 }是1。
* /:把两个数字。返回值将是一个浮点数。{ 1 / 2 }是{ { 5 } }。
* %:计算整数除数的余数。{ { 11 } }是4。
* / /:将两个数字分开，并返回整数结果。{ 20 / 7 }是2，{ { - 20 / 7 } }是- 3(这只是[round](https://twig.sensiolabs.org/doc/2.x/filters/round.html)过滤器的语法糖)。
* \*:把左边的操作数乘以右边。{ 2 } }将返回4。
#### 逻辑(Logic)
您可以将多个表达式与下列操作符组合在一起:
* and:如果左和右操作数都为真，则返回true。
* or:如果左或右操作正确，则返回true。
* not:否定。
* (expr):组织一个表达式。
> Twig还支持位运算符(b-and, b-xor, 和 b-or)。
>
> 操作符是大小写敏感的。
#### 比较(Comparisons)
下面的比较运算符在任何表达式中都被支持:= =，!= <，>，> =，and < =。
您还可以检查字符串是否以另一个字符串开头或结尾:
```markup
{% if 'Fabien' starts with 'F' %}
{% endif %}
{% if 'Fabien' ends with 'n' %}
{% endif %}
```
对于复杂的字符串比较，匹配操作符允许您使用正则表达式:
```markup
{% if phone matches '/^[\\d\\.]+$/' %}
{% endif %}
```
#### 控制操作符(Containment Operator)
in运算符执行包含测试。
如果左操作数包含在右边，则返回true:
```markup
{# returns true #}
{{ 1 in [1, 2, 3] }}
{{ 'cd' in 'abcde' }}
```
> 您可以使用此筛选器对执行遍历接口的字符串、数组或对象执行包含测试。
要做一个负面的测试，请使用not in运算符:
```markup
{% if 1 not in [1, 2, 3] %}
{# is equivalent to #}
{% if not (1 in [1, 2, 3]) %}
```
#### 测试操作符(Test Operator)
is操作符执行测试。测试可以用来测试一个变量和一个通用表达式。正确的操作数是测试的名称:
```markup
{# find out if a variable is odd #}
{{ name is odd }}
```
测试也可以接受参数:
```
{% if post.status is constant('Post::PUBLISHED') %}
```
测试可以通过使用非操作符来否定:
```
{% if post.status is not constant('Post::PUBLISHED') %}
{# is equivalent to #}
{% if not (post.status is constant('Post::PUBLISHED')) %}
```
进入[测试](https://twig.sensiolabs.org/doc/2.x/tests/index.html)页面，了解更多关于内置测试的信息。
#### 其他操作符(Other Operators)
以下的操作符不适合任何其他类别:
* \|:适用于一个过滤器。
* ..:创建一个基于操作数的序列，然后在操作符之前和之后(这是[range](https://twig.sensiolabs.org/doc/2.x/functions/range.html)函数的语法糖):
```
{{ 1..5 }}
{# equivalent to #}
{{ range(1, 5) }}
```
注意，在将它与过滤器操作符结合时必须使用括号，因为操作符优先规则:
```
(1..5)|join(', ')
```
* \~:将所有操作数转换成字符串并将它们连接起来。 将返回 (假设的名字是 'John') Hello John!.
* ., \[]: 获取对象的属性。
* ?:: 三元操作符:
```
{{ foo ? 'yes' : 'no' }}
{{ foo ?: 'no' }} is the same as {{ foo ? foo : 'no' }}
{{ foo ? 'yes' }} is the same as {{ foo ? 'yes' : '' }}
```
* ??: 空合并操作符:
```
{# returns the value of foo if it is defined and not null, 'no' otherwise #}
{{ foo ?? 'no' }}
```
#### 字符串插值(String Interpolation)
字符串插值(# { expression })允许任何有效的表达式出现在双引号内。计算表达式的结果被插入到字符串中:
```markup
{{ "foo #{bar} baz" }}
{{ "foo #{1 + 2} baz" }}
```
### 空白控制(Whitespace Control)
模板标记后的第一行自动删除(比如PHP)。模板引擎不会进一步修改空格，所以每个空格(空格、制表符、换行符等)都没有改变。\
使用无空间标记删除HTML标记之间的空格:
```
{% spaceless %}
foo bar
{% endspaceless %}
{# output will be
foo bar
#}
```
除了这个没有空间的标记之外，您还可以在每个标记级别上控制空格。通过在您的标记上使用空格控件修饰符，您可以修剪引导或跟踪空格:
```markup
{% set value = 'no spaces' %}
{#- No leading/trailing whitespace -#}
{%- if true -%}
{{- value -}}
{%- endif -%}
{# output 'no spaces' #}
```
上面的示例展示了默认的空白控件修饰符，以及如何使用它来移除标签上的空白。微调空间将消耗标记的这一侧的所有空格。可以在标签的一侧使用空格进行修剪:
```
{% set value = 'no spaces' %}
{{- value }}
{# outputs '
no spaces
' #}
```
### 扩展(Extensions)
Twig可以很容易地扩展。
如果您正在寻找新的标记、过滤器或函数，请查看Twig官方[扩展repository](http://github.com/twigphp/Twig-extensions)。
如果您想创建自己的，请阅读[创建扩展](https://twig.sensiolabs.org/doc/2.x/advanced.html#creating-extensions)章节。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://twig.shujuwajue.com/twig-2x/twig-for-mo-ban-she-ji-shi.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.