模板

前面我们说过，控制器接受请求并返回响应。然而，响应通常可以是任何内容类型。实际内容的生产是控制器委托给模板引擎的事情。然后，模板引擎有能力将响应变成HTML、JSON、XML、CSV、LaTeX或任何其他基于文本的内容类型。

在以前，程序员将PHP与HTML混合成所谓的PHP模板（.php和.phtml）。虽然现在一些平台还在使用，但这种方式被认为是不安全的，而且在很多方面都有所欠缺。其中之一就是将业务逻辑塞进模板文件中。

为了解决这些缺点，Symfony 打包了自己的模板语言Twig。与PHP不同的是，Twig的目的是严格地表达表现形式，而不是思考程序逻辑。我们无法在Twig中执行任何PHP代码。而Twig的代码不过是一个HTML，加上一些特殊的语法类型。

Twig 定义了三种类型的特殊语法：

  • {{ ... }}: 将变量或表达式的结果输出到模板中
  • {% ... %}:这个标签控制模板的逻辑（if和for循环，以及其他）
  • {# ... #}:它相当于PHP的/* comment */语法。Comments 内容不包含在渲染的页面中

过滤器是Twig的另一个不错的功能。它们就像链式方法调用一个变量值一样，在输出之前修改内容，如下所示：

  1. <h1>{{ title|upper }}</h1>
  3. {{ filter upper }}
  4. <h1>{{ title }}</h1>
  5. {% endfilter %}
  7. <h1>{{ title|lower|escape }}</h1>
  9. {% filter lower|escape %}
  10. <h1>{{ title }}</h1>
  11. {% endfilter %}

它还支持以下功能：

  1. {{ random(['phone', 'tablet', 'laptop']) }}

前面的随机函数调用会从数组中返回一个随机值。有了所有内置的过滤器和函数列表，Twig还允许我们在需要的时候自己编写。

与PHP类的继承类似，Twig也支持模板和布局的继承。让我们快速回顾一下app/Resources/views/customer/index.html.twig文件，如下所示：

  1. {% extends 'base.html.twig' %}
  3. {% block body %}
  4. <h1>Customer list</h1>
  5. …
  6. {% endblock %}

这里我们看到一个客户index.html.twig模板，使用extends标签扩展另一个模板，本例中base.html.twig在app/Resources/views/目录下找到，内容如下：

  1. <!DOCTYPE html>
  2. <html>
  3.   <head>
  4.     <meta charset="UTF-8" />
  5.     <title>{% block title %}Welcome!{% endblock %}</title>
  6.     {% block stylesheets%}{% endblock %}
  7.     <link rel="icon" type="image/x-icon"href="{{ asset('favicon.ico') }}" />
  8.   </head>
  9.   <body>
  10.     {% block body %}{% endblock %}
  11.     {% block javascripts%}{% endblock %}
  12.   </body>
  13. </html>

在这里，我们看到了几个区块标签：1title、styleheets、body和javascripts。我们可以在这里声明任意多的区块，并以任何方式命名它们。这使得扩展标签成为模板继承的关键。它告诉Twig首先评估基础模板，它设置了布局和定义了块，之后像customer/index.html.twig这样的子模板就会填充这些块的内容。

模板在两个位置：

  • app/Resources/views/
  • bundle-directory/Resources/views/

这意味着，为了 render/extend app/Resources/views/base.html.twig，我们将在模板文件中使用base.html.twig，为了render/extend app/Resources/views/customer/index.html.twig，我们将使用customer/index.html.twig路径。

当使用驻留在 bundle 中的模板时，我们必须以稍微不同的方式引用它们。在这种情况下，我们使用bundle:directory:filename字符串语法。以FoggylineCatalogBundle:Product:index.html.twig路径为例。这将是使用bundle模板文件的一个完整路径。这里FoggylineCatalogBundle是一个bundle名称，Product是该bundle Resources/views 目录下的一个目录名称，index.html.twig是Product目录下实际模板的名称。

每个模板文件名都有两个扩展名，首先指定格式，然后指定该模板的引擎；如*.html.twig、*.html.php和*.css.twig。

当我们开始构建我们的应用程序时，我们将进入关于这些模板的更多细节。