Twig (template engine)

• Complex control flow
• Automatic escaping
• Template inheritance
• Variable filters^[6]
• i18n support (gettext)
• Macros
• Fully extendable^[3][7]

Twig is supported by the following integrated development environments:^[3]

• Eclipse via the Twig plugin
• Komodo and Komodo Edit via the Twig highlight/syntax check mode
• NetBeans via the Twig syntax plugin (until 7.1, native as of 7.2)
• PhpStorm (native as of 2.1)
• IntelliJ IDEs, including WebStorm, via a plugin

And the text editors:

• Atom via the PHP-twig for atom
• Emacs via web-mode.el
• Notepad++ via the Notepad++ Twig Highlighter
• Sublime Text via the Twig bundle
• TextMate via the Twig bundle
• Vim via the Jinja syntax plugin or the vim-twig plugin
• Brackets via Brackets Twig
• Visual Studio Code via the Twig extension
• GTKSourceView via the Twig language definition
• Coda via the Twig syntax mode
• Coda 2 via the other Twig syntax mode
• SubEthaEdit via the Twig syntax mode

Twig defines three kinds of delimiters:

• {{ ... }}, to print the content of variables or the result of evaluating an expression (e.g.: an inherited Twig template with {{ parent() }}).
• {# ... #}, to add comments in the templates. These comments aren't included in the rendered page.
• {% ... %}, to execute statements, such as for-loops.
  • {% set foo = 'bar' %}, to assign.^[8]
  • {% if i is defined and i == 1%} ... {% endif %}: condition.
  • {% for i in 0..10 %} ... {% endfor %}: counter in a loop.

The apostrophe (') is the escape character.

To create an iterative array:

{% set myArray = [1, 2] %}

An associative array:

{% set myArray = {'key': 'value'} %}

The operators precedence is,^[3] from the less to more priority:

The example below demonstrates some basic features of Twig.

{% extends "base.html" %}
{% block navigation %}
    <ul id="navigation">
    {% for item in navigation %}
        <li>
            <a href="{{ item.href }}">
                {% if item.level == 2 %}&nbsp;&nbsp;{% endif %}
                {{ item.caption|upper }}
            </a>
        </li>
    {% endfor %}
    </ul>
{% endblock navigation %}

Twig has become a widely adopted templating engine in the PHP ecosystem. It is the default templating language for the Symfony framework and is also integrated into several content management systems (CMS) and applications, including:

• Drupal adopted Twig as its default template engine starting from version 8, replacing PHPTemplate.
• CraftCMS uses Twig as its sole templating language, allowing developers to create highly customised front-end experiences.
• eZ Platform (Ibexa) integrates Twig for rendering templates within its content management system.
• Bolt CMS uses Twig for theming and front-end rendering.
• ShopWired uses Twig for theming and front-end rendering.

Twig is also employed in many custom PHP applications where secure and readable templating are important. The similarity of Twig to Jinja and Django templates has also made it familiar to developers coming from Python and other similar ecosystems.

• Smarty