The include
function returns the rendered content of a template:
{{ include('template.html') }} {{ include(some_var) }}
Included templates have access to the variables of the active context.
If you are using the filesystem loader, the templates are looked for in the paths defined by it.
The context is passed by default to the template but you can also pass additional variables:
{# template.html will have access to the variables from the current context and the additional ones provided #} {{ include('template.html', {foo: 'bar'}) }}
You can disable access to the context by setting with_context
to false
:
{# only the foo variable will be accessible #} {{ include('template.html', {foo: 'bar'}, with_context = false) }}
{# no variables will be accessible #} {{ include('template.html', with_context = false) }}
And if the expression evaluates to a Twig_Template
or a Twig_TemplateWrapper
instance, Twig will use it directly:
// {{ include(template) }} $template = $twig->load('some_template.twig'); $twig->display('template.twig', array('template' => $template));
When you set the ignore_missing
flag, Twig will return an empty string if the template does not exist:
{{ include('sidebar.html', ignore_missing = true) }}
You can also provide a list of templates that are checked for existence before inclusion. The first template that exists will be rendered:
{{ include(['page_detailed.html', 'page.html']) }}
If ignore_missing
is set, it will fall back to rendering nothing if none of the templates exist, otherwise it will throw an exception.
When including a template created by an end user, you should consider sandboxing it:
{{ include('page.html', sandboxed = true) }}
template
: The template to rendervariables
: The variables to pass to the templatewith_context
: Whether to pass the current context variables or notignore_missing
: Whether to ignore missing templates or notsandboxed
: Whether to sandbox the template or not
© 2009–2017 by the Twig Team
Licensed under the three clause BSD license.
The Twig logo is © 2010–2017 SensioLabs
https://twig.sensiolabs.org/doc/2.x/functions/include.html