TwigBundle Configuration (“twig”)

• YAML

  twig:
      exception_controller:  twig.controller.exception:showAction
      form_themes:
  
          # Default:
          - form_div_layout.html.twig
  
          # Example:
          - MyBundle::form.html.twig
      globals:
  
          # Examples:
          foo:                 "@bar"
          pi:                  3.14
  
          # Example options, but the easiest use is as seen above
          some_variable_name:
              # a service id that should be the value
              id:                   ~
              # set to service or leave blank
              type:                 ~
              value:                ~
      autoescape:                ~
  
      # The following were added in Symfony 2.3.
      # See http://twig.sensiolabs.org/doc/recipes.html#using-the-template-name-to-set-the-default-escaping-strategy
      autoescape_service:        ~ # Example: @my_service
      autoescape_service_method: ~ # use in combination with autoescape_service option
      base_template_class:       ~ # Example: Twig_Template
      cache:                     "%kernel.cache_dir%/twig"
      charset:                   "%kernel.charset%"
      debug:                     "%kernel.debug%"
      strict_variables:          ~
      auto_reload:               ~
      optimizations:             ~
      paths:
          "%kernel.root_dir%/../vendor/acme/foo-bar/templates": foo_bar
  

• XML

  <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/twig/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" optimizations="true">
          <twig:form-theme>form_div_layout.html.twig</twig:form-theme> <!-- Default -->
          <twig:form-theme>MyBundle::form.html.twig</twig:form-theme>
          <twig:global key="foo" id="bar" type="service" />
          <twig:global key="pi">3.14</twig:global>
          <twig:exception-controller>AcmeFooBundle:Exception:showException</twig:exception-controller>
          <twig:path namespace="foo_bar">%kernel.root_dir%/../vendor/acme/foo-bar/templates</twig:path>
      </twig:config>
  </container>
  

• PHP

  $container->loadFromExtension('twig', array(
      'form_themes' => array(
          'form_div_layout.html.twig', // Default
          '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,
       'exception_controller' => 'AcmeFooBundle:Exception:showException',
       'optimizations'        => true,
       'paths' => array(
           '%kernel.root_dir%/../vendor/acme/foo-bar/templates' => 'foo_bar',
       ),
  ));
  

警告

The twig.form (<twig:form /> tag for xml) configuration key has been deprecated and will be removed in 3.0. Instead, use the twig.form_themes option.

Configuration¶