TwigBundle Configuration Reference

Caution: You are browsing the documentation for Symfony version 2.0 which is not maintained anymore . If some of your projects are still using this version, consider upgrading to Symfony 2.5.

TwigBundle Configuration Reference

  • YAML
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    twig:
        form:
            resources:
    
                # Default:
                - div_layout.html.twig
    
                # Example:
                - MyBundle::form.html.twig
        globals:
    
            # Examples:
            foo:                 "@bar"
            pi:                  3.14
    
            # Prototype
            key:
                id:                   ~
                type:                 ~
                value:                ~
        autoescape:           ~
        base_template_class:  ~ # Example: Twig_Template
        cache:                "%kernel.cache_dir%/twig"
        charset:              "%kernel.charset%"
        debug:                "%kernel.debug%"
        strict_variables:     ~
        auto_reload:          ~
        exception_controller:  Symfony\Bundle\TwigBundle\Controller\ExceptionController::showAction
    
  • XML
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    <container xmlns="http://symfony.com/schema/dic/services"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:twig="http://symfony.com/schema/dic/twig"
        xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
                            http://symfony.com/schema/dic/twig http://symfony.com/schema/dic/doctrine/twig-1.0.xsd">
    
        <twig:config auto-reload="%kernel.debug%" autoescape="true" base-template-class="Twig_Template" cache="%kernel.cache_dir%/twig" charset="%kernel.charset%" debug="%kernel.debug%" strict-variables="false">
            <twig:form>
                <twig:resource>MyBundle::form.html.twig</twig:resource>
            </twig:form>
            <twig:global key="foo" id="bar" type="service" />
            <twig:global key="pi">3.14</twig:global>
        </twig:config>
    </container>
    
  • PHP
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    $container->loadFromExtension('twig', array(
        'form' => array(
            'resources' => array(
                'MyBundle::form.html.twig',
            )
         ),
         'globals' => array(
             'foo' => '@bar',
             'pi'  => 3.14,
         ),
         'auto_reload'         => '%kernel.debug%',
         'autoescape'          => true,
         'base_template_class' => 'Twig_Template',
         'cache'               => '%kernel.cache_dir%/twig',
         'charset'             => '%kernel.charset%',
         'debug'               => '%kernel.debug%',
         'strict_variables'    => false,
    ));
    

Configuration

exception_controller

type: string default: Symfony\\Bundle\\TwigBundle\\Controller\\ExceptionController::showAction

This is the controller that is activated after an exception is thrown anywhere in your application. The default controller (ExceptionController) is what's responsible for rendering specific templates under different error conditions (see How to customize Error Pages). Modifying this option is advanced. If you need to customize an error page you should use the previous link. If you need to perform some behavior on an exception, you should add a listener to the kernel.exception event (see kernel.event_listener).

This work is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported License .