1-33

Symfony2 – Franz Jordán 2011
Configuring and using the templating Service
The heart of the template system in Symfony2 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('AcmeArticleBundle:Article:index.html.twig');
is equivalent to
$engine = $this->container->get('templating');
$content = $engine->render('AcmeArticleBundle:Article:index.html.twig');
return $response = new Response($content);
The templating engine (or "service") is preconfigured to work automatically inside Symfony2. It
can, of course, be configured further in the application configuration file:
# app/config/config.yml
framework:
# ...
templating: { engines: ['twig'] }
Several configuration options are available and are covered in the Configuration Appendix.
The twig engine is mandatory to use the webprofiler (as well as many third-party bundles).
Overriding Bundle Templates
The Symfony2 community prides itself on creating and maintaining high quality bundles
(seeSymfony2Bundles.org) for a large number of different features. Once you use a third-party
bundle, you'll likely need to override and customize one or more of its templates.
Suppose you've included the imaginary open-source AcmeBlogBundle in your project (e.g. in
thesrc/Acme/BlogBundle directory). And while you're really happy with everything, you want
to override the blog "list" page to customize the markup specifically for your application. By
digging into theBlog controller of the AcmeBlogBundle, you find the following:
public function indexAction()
{
$blogs = // some logic to retrieve the blogs
$this->render('AcmeBlogBundle:Blog:index.html.twig', array('blogs' =>
$blogs));
}
When the AcmeBlogBundle:Blog:index.html.twig is rendered, Symfony2 actually looks
in two different locations for the template:
1. app/Resources/AcmeBlogBundle/views/Blog/index.html.twig
2. src/Acme/BlogBundle/Resources/views/Blog/index.html.twig
To override the bundle template, just copy the index.html.twig template from the bundle
toapp/Resources/AcmeBlogBundle/views/Blog/index.html.twig (theapp/Resourc
78