The flexible, fast, and secure
template language for PHP

Twig 1.8.2 has just been released. The changelog reads as follows:

• added the abs filter
• fixed a regression when using a number in template attributes
• fixed compiler when mbstring.func_overload is set to 2
• fixed DateTimeZone support in date filter

I’ve just released Twig 1.8.1. It contains the following changes:

• fixed a regression when dealing with SimpleXMLElement instances in templates
• fixed “is_safe” value for the “dump” function when “html_errors” is not defined in php.ini
• switched to use mbstring whenever possible instead of iconv

I’m proud to announce the immediate availability of Twig 1.8.0. This version has two main new features.

The new embed tag gives the web designer yet another possibility when organizing his templates.

I have also enhanced the way autoescaping works to allow dynamic strategies to be applied (read the new recipe to learn more about that possibility). The autoescape tag syntax has also be simplified (everything is backward compatible though).

Beside the code, I’ve also reorganized the documentation and the table of contents.

I’m always looking for ways to improve the documentation and its usability. If you are always connected, the website offers a lot of documentation, easily accessible via the built-in search engine: The website short URLs allows you to quickly lookup for any built-in tag, filter, function, or test: write a URL like http://twig.sensiolabs.org/XXX where XXX is what you are looking for, and you will be redirected to the most relevant page… even if you make a typo! These shortcuts also makes easy to type in a link in a mailing-list post, an IRC conversation, or a blog post.

But today, I’m really happy to announce that you can now also download the whole Twig documentation for easy offline reading. Get the gorgeous PDF document for your laptop and get the great EPUB file for your tablet or your phone.

I’ve just released Twig 1.7.0. It contains the following changes:

• fixed template line number in some exceptions
• added an iterable test
• added an error when defining two blocks with the same name in a template
• added the preserves_safety option for filters
• fixed a PHP notice when trying to access a key on a non-object/array variable
• enhanced error reporting when the template file is an instance of SplFileInfo
• added Twig_Environment::mergeGlobals()
• added compilation checks to avoid misuses of the sandbox tag
• fixed filesystem loader freshness logic for high traffic websites
• fixed random function when charset is null

I’ve just released Twig 1.6.4. It contains the following changes:

• fixed PHP notice in Twig_Error::guessTemplateLine() introduced in 1.6.3
• fixed performance when compiling large files
• optimized parent template creation when the template does not use dynamic inheritance

I’ve just released Twig 1.6.3. It contains some minor bug fixes:

• fixed usage of Z_ADDREF_P for PHP 5.2 in the C extension;
• fixed compilation of numeric values used in templates when using a locale where the decimal separator is not a dot.

Also, the strategy used to guess the real template file name and line number in exception messages has been changed to be much faster and even more accurate than before.

Twig 1.6.2 has just been released.

This release mainly fixes the sandbox mode when used with a template using inheritance. In this specific case, the security check for the child template was not executed resulting in the possibility to use forbidden filters/tags/functions even if they were not explicitly allowed in the security policy.

If you are using the sandbox mode and allow people to use the extend tag, you must upgrade as soon as possible. The patch is here: https://github.com/fabpot/Twig/commit/50e73b20cb2cf21c06042cdb4ccd7393b8808385

I’ve just released Twig 1.6.1. It contains some minor bug fixes:

• fixed Twig C extension
• removed the creation of Twig_Markup instances when not needed
• added a way to set the default global timezone for dates
• fixed the slice filter on strings when the length is not specified
• fixed the creation of the cache directory in case of a race condition

Twig 1.6 has just been released. It fixes quite a few bugs an introduces some small new features. Here is the entire changelog for this version:

• made a speed optimization to macro calls when imported via the “from” tag
• added slice notation support for the [] operator (syntactic sugar for the slice operator)
• added a slice filter
• added string support for the reverse filter
• added a date function to ease date comparison
• added recursive parsing support in the parser

• added string and integer handling for the random function

• fixed raw blocks when used with the whitespace trim option

• fixed globals, parsers, visitors, filters, tests, and functions management in Twig_Environment when a new one or new extension is added
• fixed the attribute function when passing arguments
• fixed the empty test and the length filter for Twig_Markup instances
• fixed unary operators precedence