templating Service (Symfony 2.8 Docs)">
SymfonyCon Disneyland Paris 2021
Dec 2–3, 2021
SymfonyWorld Online 2020
Dec 3–4, 2020
SymfonyLive Berlin 2020
CANCELED
SymfonyLive Warszawa 2020
CANCELED
SymfonyLive Paris 2020
Sep 23–24, 2020
  1. Home
  2. Documentation
  3. Templating
  4. How to Configure and Use the templating Service
WARNING: You are browsing the documentation for Symfony 2.8 which is not maintained anymore. Consider upgrading your projects to Symfony 5.1.

How to Configure and Use the templating Service

2.8 version
Unmaintained
2.7 3.0 3.1 3.2

How to Configure and Use the templating Service

The heart of the template system in Symfony is the templating Engine. This special object is responsible for rendering templates and returning their content. When you render a template in a controller, for example, you’re actually using the templating engine service. For example:

return $this->render('article/index.html.twig');

is equivalent to:

use Symfony\Component\HttpFoundation\Response;

$engine = $this->container->get('templating');
$content = $engine->render('article/index.html.twig');

return $response = new Response($content);

The templating engine (or “service”) is preconfigured to work automatically inside Symfony. It can, of course, be configured further in the application configuration file:

  • YAML
    1
2
3
4
    # app/config/config.yml
framework:
    # ...
    templating: { engines: ['twig'] }
  • XML
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
    <!-- app/config/config.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <!-- ... -->
    <framework:config>
        <framework:templating>
            <framework:engine>twig</framework:engine>
        </framework:templating>
    </framework:config>
</container>
  • PHP
    1
2
3
4
5
6
7
    // app/config/config.php
$container->loadFromExtension('framework', array(
    // ...
    'templating' => array(
        'engines' => array('twig'),
    ),
));

Several configuration options are available and are covered in the Configuration Appendix.

Note

The twig engine is mandatory to use the webprofiler (as well as many third-party bundles).

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.