1-33

Symfony2 – Franz Jordán 2011
es/AcmeBlogBundle directory won't exist, so you'll need to create it). You're now free to
customize the template.
This logic also applies to base bundle templates. Suppose also that each template
inAcmeBlogBundle inherits from a base template
called AcmeBlogBundle::layout.html.twig. Just as before, Symfony2 will look in the
following two places for the template:
1. app/Resources/AcmeBlogBundle/views/layout.html.twig
2. src/Acme/BlogBundle/Resources/views/layout.html.twig
Once again, to override the template, just copy it from the bundle
toapp/Resources/AcmeBlogBundle/views/layout.html.twig. You're now free to
customize this copy as you see fit.
If you take a step back, you'll see that Symfony2 always starts by looking in
theapp/Resources/{BUNDLE_NAME}/views/ directory for a template. If the template
doesn't exist there, it continues by checking inside the Resources/views directory of the
bundle itself. This means that all bundle templates can be overridden by placing them in the
correct app/Resources subdirectory.
Overriding Core Templates
Since the Symfony2 framework itself is just a bundle, core templates can be overridden in the
same way. For example, the core TwigBundle contains a number of different "exception" and
"error" templates that can be overridden by copying each from
the Resources/views/Exception directory of the TwigBundle to, you guessed it,
the app/Resources/TwigBundle/views/Exception directory.
Three-level Inheritance
One common way to use inheritance is to use a three-level approach. This method works
perfectly with the three different types of templates we've just covered:
Create a app/Resources/views/base.html.twig file that contains the main layout
for your application (like in the previous example). Internally, this template is
called::base.html.twig;
Create a template for each "section" of your site. For example, an AcmeBlogBundle,
would have a template called AcmeBlogBundle::layout.html.twig that contains
only blog section-specific elements;
{# src/Acme/BlogBundle/Resources/views/layout.html.twig #}
{% extends '::base.html.twig' %}
{% block body %}
Blog Application
{% block content %}{% endblock %}
{% endblock %}
Create individual templates for each page and make each extend the appropriate section
template. For example, the "index" page would be called something close
toAcmeBlogBundle:Blog:index.html.twig and list the actual blog posts.
79