3 * ensured that syntax errors are triggered with the right line
4 * added the Symfony ctype polyfill as a dependency
5 * "js" filter now produces valid JSON
9 * fixed block names unicity
10 * fixed counting children of SimpleXMLElement objects
11 * added missing else clause to avoid infinite loops
12 * fixed .. (range operator) in sandbox policy
16 * fixed a regression in the way the profiler is registered in templates
20 * added an exception when using "===" instead of "same as"
21 * fixed possible array to string conversion concealing actual error
22 * made variable names deterministic in compiled templates
23 * fixed length filter when passing an instance of IteratorAggregate
24 * fixed Environment::resolveTemplate to accept instances of TemplateWrapper
28 * added Twig_Profiler_Profile::reset()
29 * fixed use TokenParser to return an empty Node
30 * added RuntimeExtensionInterface
31 * added circular reference detection when loading templates
35 * added support for runtime loaders in IntegrationTestCase
36 * fixed deprecation when using Twig_Profiler_Dumper_Html
40 * fixed namespaces introduction
44 * fixed namespaces introduction
48 * fixed namespaces introduction
52 * added support for PHPUnit 6 when testing extensions
53 * fixed PHP 7.2 compatibility
54 * fixed template name generation in Twig_Environment::createTemplate()
55 * removed final tag on Twig_TokenParser_Include
56 * added namespaced aliases for all (non-deprecated) classes and interfaces
57 * dropped HHVM support
58 * dropped PHP 5.2 support
62 * fixed edge case in the method cache for Twig attributes
66 * fixed the empty() test
70 * fixed a race condition handling when writing cache files
71 * "length" filter now returns string length when applied to an object that does
72 not implement \Countable but provides __toString()
73 * "empty" test will now consider the return value of the __toString() method for
74 objects implement __toString() but not \Countable
75 * fixed JS escaping for unicode characters with higher code points
79 * fixed deprecation notice in Twig_Util_DeprecationCollector
80 * added a PSR-11 compatible runtime loader
81 * added `side` argument to `trim` to allow left or right trimming only.
85 * added Twig_NodeCaptureInterface for nodes that capture all output
86 * fixed marking the environment as initialized too early
87 * fixed C89 compat for the C extension
88 * turned fatal error into exception when a previously generated cache is corrupted
89 * fixed offline cache warm-ups for embedded templates
93 * added Twig_FactoryRuntimeLoader
94 * deprecated function/test/filter/tag overriding
95 * deprecated the "disable_c_ext" attribute on Twig_Node_Expression_GetAttr
99 * fixed sandbox being left enabled if an exception is thrown while rendering
100 * marked some classes as being final (via @final)
101 * made Twig_Error report real source path when possible
102 * added support for {{ _self }} to provide an upgrade path from 1.x to 2.0 (replaces {{ _self.templateName }})
103 * deprecated silent display of undefined blocks
104 * deprecated support for mbstring.func_overload != 0
106 * 1.28.2 (2016-11-23)
108 * fixed precedence between getFoo() and isFoo() in Twig_Template::getAttribute()
109 * improved a deprecation message
111 * 1.28.1 (2016-11-18)
113 * fixed block() function when used with a template argument
115 * 1.28.0 (2016-11-17)
117 * added support for the PHP 7 null coalescing operator for the ?? Twig implementation
118 * exposed a way to access template data and methods in a portable way
119 * changed context access to use the PHP 7 null coalescing operator when available
120 * added the "with" tag
121 * added support for a custom template on the block() function
122 * added "is defined" support for block() and constant()
123 * optimized the way attributes are fetched
125 * 1.27.0 (2016-10-25)
127 * deprecated Twig_Parser::getEnvironment()
128 * deprecated Twig_Parser::addHandler() and Twig_Parser::addNodeVisitor()
129 * deprecated Twig_Compiler::addIndentation()
130 * fixed regression when registering two extensions having the same class name
131 * deprecated Twig_LoaderInterface::getSource() (implement Twig_SourceContextLoaderInterface instead)
132 * fixed the filesystem loader with relative paths
133 * deprecated Twig_Node::getLine() in favor of Twig_Node::getTemplateLine()
134 * deprecated Twig_Template::getSource() in favor of Twig_Template::getSourceContext()
135 * deprecated Twig_Node::getFilename() in favor of Twig_Node::getTemplateName()
136 * deprecated the "filename" escaping strategy (use "name" instead)
137 * added Twig_Source to hold information about the original template
138 * deprecated Twig_Error::getTemplateFile() and Twig_Error::setTemplateFile() in favor of Twig_Error::getTemplateName() and Twig_Error::setTemplateName()
139 * deprecated Parser::getFilename()
140 * fixed template paths when a template name contains a protocol like vfs://
141 * improved debugging with Twig_Sandbox_SecurityError exceptions for disallowed methods and properties
143 * 1.26.1 (2016-10-05)
145 * removed template source code from generated template classes when debug is disabled
146 * fixed default implementation of Twig_Template::getDebugInfo() for better BC
147 * fixed regression on static calls for functions/filters/tests
149 * 1.26.0 (2016-10-02)
151 * added template cache invalidation based on more environment options
152 * added a missing deprecation notice
153 * fixed template paths when a template is stored in a PHAR file
154 * allowed filters/functions/tests implementation to use a different class than the extension they belong to
155 * deprecated Twig_ExtensionInterface::getName()
157 * 1.25.0 (2016-09-21)
159 * changed the way we store template source in template classes
160 * removed usage of realpath in cache keys
161 * fixed Twig cache sharing when used with different versions of PHP
162 * removed embed parent workaround for simple use cases
163 * deprecated the ability to store non Node instances in Node::$nodes
164 * deprecated Twig_Environment::getLexer(), Twig_Environment::getParser(), Twig_Environment::getCompiler()
165 * deprecated Twig_Compiler::getFilename()
167 * 1.24.2 (2016-09-01)
169 * fixed static callables
170 * fixed a potential PHP warning when loading the cache
171 * fixed a case where the autoescaping does not work as expected
173 * 1.24.1 (2016-05-30)
175 * fixed reserved keywords (forbids true, false, null and none keywords for variables names)
176 * fixed support for PHP7 (Throwable support)
177 * marked the following methods as being internals on Twig_Environment:
178 getFunctions(), getFilters(), getTests(), getFunction(), getFilter(), getTest(),
179 getTokenParsers(), getTags(), getNodeVisitors(), getUnaryOperators(), getBinaryOperators(),
180 getFunctions(), getFilters(), getGlobals(), initGlobals(), initExtensions(), and initExtension()
182 * 1.24.0 (2016-01-25)
184 * adding support for the ?? operator
185 * fixed the defined test when used on a constant, a map, or a sequence
186 * undeprecated _self (should only be used to get the template name, not the template instance)
187 * fixed parsing on PHP7
189 * 1.23.3 (2016-01-11)
193 * 1.23.2 (2015-01-11)
195 * added versions in deprecated messages
196 * made file cache tolerant for trailing (back)slashes on directory configuration
197 * deprecated unused Twig_Node_Expression_ExtensionReference class
199 * 1.23.1 (2015-11-05)
201 * fixed some exception messages which triggered PHP warnings
202 * fixed BC on Twig_Test_NodeTestCase
204 * 1.23.0 (2015-10-29)
206 * deprecated the possibility to override an extension by registering another one with the same name
207 * deprecated Twig_ExtensionInterface::getGlobals() (added Twig_Extension_GlobalsInterface for BC)
208 * deprecated Twig_ExtensionInterface::initRuntime() (added Twig_Extension_InitRuntimeInterface for BC)
209 * deprecated Twig_Environment::computeAlternatives()
211 * 1.22.3 (2015-10-13)
213 * fixed regression when using null as a cache strategy
214 * improved performance when checking template freshness
215 * fixed warnings when loaded templates do not exist
216 * fixed template class name generation to prevent possible collisions
217 * fixed logic for custom escapers to call them even on integers and null values
218 * changed template cache names to take into account the Twig C extension
220 * 1.22.2 (2015-09-22)
222 * fixed a race condition in template loading
224 * 1.22.1 (2015-09-15)
226 * fixed regression in template_from_string
228 * 1.22.0 (2015-09-13)
230 * made Twig_Test_IntegrationTestCase more flexible
231 * added an option to force PHP bytecode invalidation when writing a compiled template into the cache
232 * fixed the profiler duration for the root node
233 * changed template cache names to take into account enabled extensions
234 * deprecated Twig_Environment::clearCacheFiles(), Twig_Environment::getCacheFilename(),
235 Twig_Environment::writeCacheFile(), and Twig_Environment::getTemplateClassPrefix()
236 * added a way to override the filesystem template cache system
237 * added a way to get the original template source from Twig_Template
239 * 1.21.2 (2015-09-09)
241 * fixed variable names for the deprecation triggering code
242 * fixed escaping strategy detection based on filename
243 * added Traversable support for replace, merge, and sort
244 * deprecated support for character by character replacement for the "replace" filter
246 * 1.21.1 (2015-08-26)
248 * fixed regression when using the deprecated Twig_Test_* classes
250 * 1.21.0 (2015-08-24)
252 * added deprecation notices for deprecated features
253 * added a deprecation "framework" for filters/functions/tests and test fixtures
255 * 1.20.0 (2015-08-12)
257 * forbid access to the Twig environment from templates and internal parts of Twig_Template
258 * fixed limited RCEs when in sandbox mode
259 * deprecated Twig_Template::getEnvironment()
260 * deprecated the _self variable for usage outside of the from and import tags
261 * added Twig_BaseNodeVisitor to ease the compatibility of node visitors
264 * 1.19.0 (2015-07-31)
266 * fixed wrong error message when including an undefined template in a child template
267 * added support for variadic filters, functions, and tests
268 * added support for extra positional arguments in macros
269 * added ignore_missing flag to the source function
270 * fixed batch filter with zero items
271 * deprecated Twig_Environment::clearTemplateCache()
272 * fixed sandbox disabling when using the include function
274 * 1.18.2 (2015-06-06)
276 * fixed template/line guessing in exceptions for nested templates
277 * optimized the number of inodes and the size of realpath cache when using the cache
279 * 1.18.1 (2015-04-19)
281 * fixed memory leaks in the C extension
282 * deprecated Twig_Loader_String
283 * fixed the slice filter when used with a SimpleXMLElement object
284 * fixed filesystem loader when trying to load non-files (like directories)
286 * 1.18.0 (2015-01-25)
288 * fixed some error messages where the line was wrong (unknown variables or argument names)
289 * added a new way to customize the main Module node (via empty nodes)
290 * added Twig_Environment::createTemplate() to create a template from a string
292 * fixed filesystem loader cache when different file paths are used for the same template
294 * 1.17.0 (2015-01-14)
296 * added a 'filename' autoescaping strategy, which dynamically chooses the
297 autoescaping strategy for a template based on template file extension.
299 * 1.16.3 (2014-12-25)
301 * fixed regression for dynamic parent templates
302 * fixed cache management with statcache
303 * fixed a regression in the slice filter
305 * 1.16.2 (2014-10-17)
307 * fixed timezone on dates as strings
308 * fixed 2-words test names when a custom node class is not used
309 * fixed macros when using an argument named like a PHP super global (like GET or POST)
310 * fixed date_modify when working with DateTimeImmutable
311 * optimized for loops
312 * fixed multi-byte characters handling in the split filter
313 * fixed a regression in the in operator
314 * fixed a regression in the slice filter
316 * 1.16.1 (2014-10-10)
318 * improved error reporting in a sandboxed template
319 * fixed missing error file/line information under certain circumstances
320 * fixed wrong error line number in some error messages
321 * fixed the in operator to use strict comparisons
322 * sped up the slice filter
323 * fixed for mb function overload mb_substr acting different
324 * fixed the attribute() function when passing a variable for the arguments
326 * 1.16.0 (2014-07-05)
328 * changed url_encode to always encode according to RFC 3986
329 * fixed inheritance in a 'use'-hierarchy
330 * removed the __toString policy check when the sandbox is disabled
331 * fixed recursively calling blocks in templates with inheritance
333 * 1.15.1 (2014-02-13)
335 * fixed the conversion of the special '0000-00-00 00:00' date
336 * added an error message when trying to import an undefined block from a trait
337 * fixed a C extension crash when accessing defined but uninitialized property.
339 * 1.15.0 (2013-12-06)
341 * made ignoreStrictCheck in Template::getAttribute() works with __call() methods throwing BadMethodCallException
342 * added min and max functions
343 * added the round filter
344 * fixed a bug that prevented the optimizers to be enabled/disabled selectively
345 * fixed first and last filters for UTF-8 strings
346 * added a source function to include the content of a template without rendering it
347 * fixed the C extension sandbox behavior when get or set is prepend to method name
349 * 1.14.2 (2013-10-30)
351 * fixed error filename/line when an error occurs in an included file
352 * allowed operators that contain whitespaces to have more than one whitespace
353 * allowed tests to be made of 1 or 2 words (like "same as" or "divisible by")
355 * 1.14.1 (2013-10-15)
357 * made it possible to use named operators as variables
358 * fixed the possibility to have a variable named 'matches'
359 * added support for PHP 5.5 DateTimeInterface
361 * 1.14.0 (2013-10-03)
363 * fixed usage of the html_attr escaping strategy to avoid double-escaping with the html strategy
364 * added new operators: ends with, starts with, and matches
365 * fixed some compatibility issues with HHVM
366 * added a way to add custom escaping strategies
367 * fixed the C extension compilation on Windows
368 * fixed the batch filter when using a fill argument with an exact match of elements to batch
369 * fixed the filesystem loader cache when a template name exists in several namespaces
370 * fixed template_from_string when the template includes or extends other ones
371 * fixed a crash of the C extension on an edge case
373 * 1.13.2 (2013-08-03)
375 * fixed the error line number for an error occurs in and embedded template
376 * fixed crashes of the C extension on some edge cases
378 * 1.13.1 (2013-06-06)
380 * added the possibility to ignore the filesystem constructor argument in Twig_Loader_Filesystem
381 * fixed Twig_Loader_Chain::exists() for a loader which implements Twig_ExistsLoaderInterface
382 * adjusted backtrace call to reduce memory usage when an error occurs
383 * added support for object instances as the second argument of the constant test
384 * fixed the include function when used in an assignment
386 * 1.13.0 (2013-05-10)
388 * fixed getting a numeric-like item on a variable ('09' for instance)
389 * fixed getting a boolean or float key on an array, so it is consistent with PHP's array access:
390 `{{ array[false] }}` behaves the same as `echo $array[false];` (equals `$array[0]`)
391 * made the escape filter 20% faster for happy path (escaping string for html with UTF-8)
392 * changed ☃ to § in tests
393 * enforced usage of named arguments after positional ones
395 * 1.12.3 (2013-04-08)
397 * fixed a security issue in the filesystem loader where it was possible to include a template one
398 level above the configured path
399 * fixed fatal error that should be an exception when adding a filter/function/test too late
400 * added a batch filter
401 * added support for encoding an array as query string in the url_encode filter
403 * 1.12.2 (2013-02-09)
405 * fixed the timezone used by the date filter and function when the given date contains a timezone (like 2010-01-28T15:00:00+02:00)
406 * fixed globals when getGlobals is called early on
407 * added the first and last filter
409 * 1.12.1 (2013-01-15)
411 * added support for object instances as the second argument of the constant function
412 * relaxed globals management to avoid a BC break
413 * added support for {{ some_string[:2] }}
415 * 1.12.0 (2013-01-08)
417 * added verbatim as an alias for the raw tag to avoid confusion with the raw filter
418 * fixed registration of tests and functions as anonymous functions
419 * fixed globals management
421 * 1.12.0-RC1 (2012-12-29)
423 * added an include function (does the same as the include tag but in a more flexible way)
424 * added the ability to use any PHP callable to define filters, functions, and tests
425 * added a syntax error when using a loop variable that is not defined
426 * added the ability to set default values for macro arguments
427 * added support for named arguments for filters, tests, and functions
428 * moved filters/functions/tests syntax errors to the parser
429 * added support for extended ternary operator syntaxes
431 * 1.11.1 (2012-11-11)
433 * fixed debug info line numbering (was off by 2)
434 * fixed escaping when calling a macro inside another one (regression introduced in 1.9.1)
435 * optimized variable access on PHP 5.4
436 * fixed a crash of the C extension when an exception was thrown from a macro called without being imported (using _self.XXX)
438 * 1.11.0 (2012-11-07)
440 * fixed macro compilation when a variable name is a PHP reserved keyword
441 * changed the date filter behavior to always apply the default timezone, except if false is passed as the timezone
442 * fixed bitwise operator precedences
443 * added the template_from_string function
444 * fixed default timezone usage for the date function
445 * optimized the way Twig exceptions are managed (to make them faster)
446 * added Twig_ExistsLoaderInterface (implementing this interface in your loader make the chain loader much faster)
448 * 1.10.3 (2012-10-19)
450 * fixed wrong template location in some error messages
451 * reverted a BC break introduced in 1.10.2
452 * added a split filter
454 * 1.10.2 (2012-10-15)
456 * fixed macro calls on PHP 5.4
458 * 1.10.1 (2012-10-15)
460 * made a speed optimization to macro calls when imported via the "import" tag
461 * fixed C extension compilation on Windows
462 * fixed a segfault in the C extension when using DateTime objects
464 * 1.10.0 (2012-09-28)
466 * extracted functional tests framework to make it reusable for third-party extensions
467 * added namespaced templates support in Twig_Loader_Filesystem
468 * added Twig_Loader_Filesystem::prependPath()
469 * fixed an error when a token parser pass a closure as a test to the subparse() method
473 * fixed the in operator for objects that contain circular references
474 * fixed the C extension when accessing a public property of an object implementing the \ArrayAccess interface
478 * optimized macro calls when auto-escaping is on
479 * fixed wrong parent class for Twig_Function_Node
480 * made Twig_Loader_Chain more explicit about problems
484 * made the parsing independent of the template loaders
485 * fixed exception trace when an error occurs when rendering a child template
486 * added escaping strategies for CSS, URL, and HTML attributes
487 * fixed nested embed tag calls
488 * added the date_modify filter
492 * fixed paths in the filesystem loader when passing a path that ends with a slash or a backslash
493 * fixed escaping when a project defines a function named html or js
494 * fixed chmod mode to apply the umask correctly
498 * added the abs filter
499 * fixed a regression when using a number in template attributes
500 * fixed compiler when mbstring.func_overload is set to 2
501 * fixed DateTimeZone support in date filter
505 * fixed a regression when dealing with SimpleXMLElement instances in templates
506 * fixed "is_safe" value for the "dump" function when "html_errors" is not defined in php.ini
507 * switched to use mbstring whenever possible instead of iconv (you might need to update your encoding as mbstring and iconv encoding names sometimes differ)
511 * enforced interface when adding tests, filters, functions, and node visitors from extensions
512 * fixed a side-effect of the date filter where the timezone might be changed
513 * simplified usage of the autoescape tag; the only (optional) argument is now the escaping strategy or false (with a BC layer)
514 * added a way to dynamically change the auto-escaping strategy according to the template "filename"
515 * changed the autoescape option to also accept a supported escaping strategy (for BC, true is equivalent to html)
520 * fixed a PHP warning when using CIFS
521 * fixed template line number in some exceptions
522 * added an iterable test
523 * added an error when defining two blocks with the same name in a template
524 * added the preserves_safety option for filters
525 * fixed a PHP notice when trying to access a key on a non-object/array variable
526 * enhanced error reporting when the template file is an instance of SplFileInfo
527 * added Twig_Environment::mergeGlobals()
528 * added compilation checks to avoid misuses of the sandbox tag
529 * fixed filesystem loader freshness logic for high traffic websites
530 * fixed random function when charset is null
534 * fixed a regression when a template only extends another one without defining any blocks
538 * fixed PHP notice in Twig_Error::guessTemplateLine() introduced in 1.6.3
539 * fixed performance when compiling large files
540 * optimized parent template creation when the template does not use dynamic inheritance
544 * fixed usage of Z_ADDREF_P for PHP 5.2 in the C extension
545 * fixed compilation of numeric values used in templates when using a locale where the decimal separator is not a dot
546 * made the strategy used to guess the real template file name and line number in exception messages much faster and more accurate
550 * fixed sandbox mode when used with inheritance
551 * added preserveKeys support for the slice filter
552 * fixed the date filter when a DateTime instance is passed with a specific timezone
553 * added a trim filter
557 * fixed Twig C extension
558 * removed the creation of Twig_Markup instances when not needed
559 * added a way to set the default global timezone for dates
560 * fixed the slice filter on strings when the length is not specified
561 * fixed the creation of the cache directory in case of a race condition
565 * fixed raw blocks when used with the whitespace trim option
566 * made a speed optimization to macro calls when imported via the "from" tag
567 * fixed globals, parsers, visitors, filters, tests, and functions management in Twig_Environment when a new one or new extension is added
568 * fixed the attribute function when passing arguments
569 * added slice notation support for the [] operator (syntactic sugar for the slice operator)
570 * added a slice filter
571 * added string support for the reverse filter
572 * fixed the empty test and the length filter for Twig_Markup instances
573 * added a date function to ease date comparison
574 * fixed unary operators precedence
575 * added recursive parsing support in the parser
576 * added string and integer handling for the random function
580 * fixed a regression when parsing strings
584 * added Traversable objects support for the join filter
586 * 1.5.0-RC2 (2011-12-30)
588 * added a way to set the default global date interval format
589 * fixed the date filter for DateInterval instances (setTimezone() does not exist for them)
590 * refactored Twig_Template::display() to ease its extension
591 * added a number_format filter
593 * 1.5.0-RC1 (2011-12-26)
595 * removed the need to quote hash keys
596 * allowed hash keys to be any expression
599 * added support for dynamically named filters and functions
600 * added a dump function to help debugging templates
601 * added a nl2br filter
602 * added a random function
603 * added a way to change the default format for the date filter
604 * fixed the lexer when an operator ending with a letter ends a line
605 * added string interpolation support
606 * enhanced exceptions for unknown filters, functions, tests, and tags
610 * fixed lexer when using big numbers (> PHP_INT_MAX)
611 * added missing preserveKeys argument to the reverse filter
612 * fixed macros containing filter tag calls
614 * 1.4.0-RC2 (2011-11-27)
616 * removed usage of Reflection in Twig_Template::getAttribute()
617 * added a C extension that can optionally replace Twig_Template::getAttribute()
618 * added negative timestamp support to the date filter
620 * 1.4.0-RC1 (2011-11-20)
622 * optimized variable access when using PHP 5.4
623 * changed the precedence of the .. operator to be more consistent with languages that implements such a feature like Ruby
624 * added an Exception to Twig_Loader_Array::isFresh() method when the template does not exist to be consistent with other loaders
625 * added Twig_Function_Node to allow more complex functions to have their own Node class
626 * added Twig_Filter_Node to allow more complex filters to have their own Node class
627 * added Twig_Test_Node to allow more complex tests to have their own Node class
628 * added a better error message when a template is empty but contain a BOM
629 * fixed "in" operator for empty strings
630 * fixed the "defined" test and the "default" filter (now works with more than one call (foo.bar.foo) and for both values of the strict_variables option)
631 * changed the way extensions are loaded (addFilter/addFunction/addGlobal/addTest/addNodeVisitor/addTokenParser/addExtension can now be called in any order)
632 * added Twig_Environment::display()
633 * made the escape filter smarter when the encoding is not supported by PHP
634 * added a convert_encoding filter
635 * moved all node manipulations outside the compile() Node method
636 * made several speed optimizations
642 * 1.3.0-RC1 (2011-10-04)
644 * added an optimization for the parent() function
645 * added cache reloading when auto_reload is true and an extension has been modified
646 * added the possibility to force the escaping of a string already marked as safe (instance of Twig_Markup)
647 * allowed empty templates to be used as traits
648 * added traits support for the "parent" function
654 * 1.2.0-RC1 (2011-09-10)
656 * enhanced the exception when a tag remains unclosed
657 * added support for empty Countable objects for the "empty" test
658 * fixed algorithm that determines if a template using inheritance is valid (no output between block definitions)
659 * added better support for encoding problems when escaping a string (available as of PHP 5.4)
660 * added a way to ignore a missing template when using the "include" tag ({% include "foo" ignore missing %})
661 * added support for an array of templates to the "include" and "extends" tags ({% include ['foo', 'bar'] %})
662 * added support for bitwise operators in expressions
663 * added the "attribute" function to allow getting dynamic attributes on variables
664 * added Twig_Loader_Chain
665 * added Twig_Loader_Array::setTemplate()
666 * added an optimization for the set tag when used to capture a large chunk of static text
667 * changed name regex to match PHP one "[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*" (works for blocks, tags, functions, filters, and macros)
668 * removed the possibility to use the "extends" tag from a block
669 * added "if" modifier support to "for" loops
673 * fixed json_encode filter on PHP 5.2
674 * fixed regression introduced in 1.1.1 ({{ block(foo|lower) }})
675 * fixed inheritance when using conditional parents
676 * fixed compilation of templates when the body of a child template is not empty
677 * fixed output when a macro throws an exception
678 * fixed a parsing problem when a large chunk of text is enclosed in a comment tag
679 * added PHPDoc for all Token parsers and Core extension functions
683 * added a performance optimization in the Optimizer (also helps to lower the number of nested level calls)
684 * made some performance improvement for some edge cases
688 * fixed json_encode filter
690 * 1.1.0-RC3 (2011-06-24)
692 * fixed method case-sensitivity when using the sandbox mode
693 * added timezone support for the date filter
694 * fixed possible security problems with NUL bytes
696 * 1.1.0-RC2 (2011-06-16)
698 * added an exception when the template passed to "use" is not a string
699 * made 'a.b is defined' not throw an exception if a is not defined (in strict mode)
700 * added {% line \d+ %} directive
702 * 1.1.0-RC1 (2011-05-28)
704 Flush your cache after upgrading.
706 * fixed date filter when using a timestamp
707 * fixed the defined test for some cases
708 * fixed a parsing problem when a large chunk of text is enclosed in a raw tag
709 * added support for horizontal reuse of template blocks (see docs for more information)
710 * added whitespace control modifier to all tags (see docs for more information)
711 * added null as an alias for none (the null test is also an alias for the none test now)
712 * made TRUE, FALSE, NONE equivalent to their lowercase counterparts
713 * wrapped all compilation and runtime exceptions with Twig_Error_Runtime and added logic to guess the template name and line
714 * moved display() method to Twig_Template (generated templates should now use doDisplay() instead)
718 * fixed output when using mbstring
719 * fixed duplicate call of methods when using the sandbox
720 * made the charset configurable for the escape filter
722 * 1.0.0-RC2 (2011-02-21)
724 * changed the way {% set %} works when capturing (the content is now marked as safe)
725 * added support for macro name in the endmacro tag
726 * make Twig_Error compatible with PHP 5.3.0 >
727 * fixed an infinite loop on some Windows configurations
728 * fixed the "length" filter for numbers
729 * fixed Template::getAttribute() as properties in PHP are case sensitive
730 * removed coupling between Twig_Node and Twig_Template
731 * fixed the ternary operator precedence rule
733 * 1.0.0-RC1 (2011-01-09)
735 Backward incompatibilities:
737 * the "items" filter, which has been deprecated for quite a long time now, has been removed
738 * the "range" filter has been converted to a function: 0|range(10) -> range(0, 10)
739 * the "constant" filter has been converted to a function: {{ some_date|date('DATE_W3C'|constant) }} -> {{ some_date|date(constant('DATE_W3C')) }}
740 * the "cycle" filter has been converted to a function: {{ ['odd', 'even']|cycle(i) }} -> {{ cycle(['odd', 'even'], i) }}
741 * the "for" tag does not support "joined by" anymore
742 * the "autoescape" first argument is now "true"/"false" (instead of "on"/"off")
743 * the "parent" tag has been replaced by a "parent" function ({{ parent() }} instead of {% parent %})
744 * the "display" tag has been replaced by a "block" function ({{ block('title') }} instead of {% display title %})
745 * removed the grammar and simple token parser (moved to the Twig Extensions repository)
749 * added "needs_context" option for filters and functions (the context is then passed as a first argument)
750 * added global variables support
751 * made macros return their value instead of echoing directly (fixes calling a macro in sandbox mode)
752 * added the "from" tag to import macros as functions
753 * added support for functions (a function is just syntactic sugar for a getAttribute() call)
754 * made macros callable when sandbox mode is enabled
755 * added an exception when a macro uses a reserved name
756 * the "default" filter now uses the "empty" test instead of just checking for null
757 * added the "empty" test
759 * 0.9.10 (2010-12-16)
761 Backward incompatibilities:
763 * The Escaper extension is enabled by default, which means that all displayed
764 variables are now automatically escaped. You can revert to the previous
765 behavior by removing the extension via $env->removeExtension('escaper')
766 or just set the 'autoescape' option to 'false'.
767 * removed the "without loop" attribute for the "for" tag (not needed anymore
768 as the Optimizer take care of that for most cases)
769 * arrays and hashes have now a different syntax
770 * arrays keep the same syntax with square brackets: [1, 2]
771 * hashes now use curly braces (["a": "b"] should now be written as {"a": "b"})
772 * support for "arrays with keys" and "hashes without keys" is not supported anymore ([1, "foo": "bar"] or {"foo": "bar", 1})
773 * the i18n extension is now part of the Twig Extensions repository
777 * added the merge filter
778 * removed 'is_escaper' option for filters (a left over from the previous version) -- you must use 'is_safe' now instead
779 * fixed usage of operators as method names (like is, in, and not)
780 * changed the order of execution for node visitors
781 * fixed default() filter behavior when used with strict_variables set to on
782 * fixed filesystem loader compatibility with PHAR files
783 * enhanced error messages when an unexpected token is parsed in an expression
784 * fixed filename not being added to syntax error messages
785 * added the autoescape option to enable/disable autoescaping
786 * removed the newline after a comment (mimics PHP behavior)
787 * added a syntax error exception when parent block is used on a template that does not extend another one
788 * made the Escaper extension enabled by default
789 * fixed sandbox extension when used with auto output escaping
790 * fixed escaper when wrapping a Twig_Node_Print (the original class must be preserved)
791 * added an Optimizer extension (enabled by default; optimizes "for" loops and "raw" filters)
792 * added priority to node visitors
796 Backward incompatibilities:
797 * the self special variable has been renamed to _self
798 * the odd and even filters are now tests:
799 {{ foo|odd }} must now be written {{ foo is odd }}
800 * the "safe" filter has been renamed to "raw"
802 sub-nodes are now accessed via getNode() (instead of property access)
803 attributes via getAttribute() (instead of array access)
804 * the urlencode filter had been renamed to url_encode
805 * the include tag now merges the passed variables with the current context by default
806 (the old behavior is still possible by adding the "only" keyword)
807 * moved Exceptions to Twig_Error_* (Twig_SyntaxError/Twig_RuntimeError are now Twig_Error_Syntax/Twig_Error_Runtime)
808 * removed support for {{ 1 < i < 3 }} (use {{ i > 1 and i < 3 }} instead)
809 * the "in" filter has been removed ({{ a|in(b) }} should now be written {{ a in b }})
812 * added file and line to Twig_Error_Runtime exceptions thrown from Twig_Template
813 * changed trans tag to accept any variable for the plural count
814 * fixed sandbox mode (__toString() method check was not enforced if called implicitly from complex statements)
815 * added the ** (power) operator
816 * changed the algorithm used for parsing expressions
817 * added the spaceless tag
818 * removed trim_blocks option
819 * added support for is*() methods for attributes (foo.bar now looks for foo->getBar() or foo->isBar())
820 * changed all exceptions to extend Twig_Error
821 * fixed unary expressions ({{ not(1 or 0) }})
822 * fixed child templates (with an extend tag) that uses one or more imports
823 * added support for {{ 1 not in [2, 3] }} (more readable than the current {{ not (1 in [2, 3]) }})
824 * escaping has been rewritten
825 * the implementation of template inheritance has been rewritten
826 (blocks can now be called individually and still work with inheritance)
827 * fixed error handling for if tag when a syntax error occurs within a subparse process
828 * added a way to implement custom logic for resolving token parsers given a tag name
829 * fixed js escaper to be stricter (now uses a whilelist-based js escaper)
830 * added the following filers: "constant", "trans", "replace", "json_encode"
831 * added a "constant" test
832 * fixed objects with __toString() not being autoescaped
833 * fixed subscript expressions when calling __call() (methods now keep the case)
834 * added "test" feature (accessible via the "is" operator)
835 * removed the debug tag (should be done in an extension)
836 * fixed trans tag when no vars are used in plural form
837 * fixed race condition when writing template cache
838 * added the special _charset variable to reference the current charset
839 * added the special _context variable to reference the current context
840 * renamed self to _self (to avoid conflict)
841 * fixed Twig_Template::getAttribute() for protected properties
845 Backward incompatibilities:
846 * the trans tag plural count is now attached to the plural tag:
847 old: `{% trans count %}...{% plural %}...{% endtrans %}`
848 new: `{% trans %}...{% plural count %}...{% endtrans %}`
850 * added a way to translate strings coming from a variable ({% trans var %})
851 * fixed trans tag when used with the Escaper extension
852 * fixed default cache umask
853 * removed Twig_Template instances from the debug tag output
854 * fixed objects with __isset() defined
855 * fixed set tag when used with a capture
856 * fixed type hinting for Twig_Environment::addFilter() method
860 Backward incompatibilities:
861 * changed 'as' to '=' for the set tag ({% set title as "Title" %} must now be {% set title = "Title" %})
862 * removed the sandboxed attribute of the include tag (use the new sandbox tag instead)
863 * refactored the Node system (if you have custom nodes, you will have to update them to use the new API)
865 * added self as a special variable that refers to the current template (useful for importing macros from the current template)
866 * added Twig_Template instance support to the include tag
867 * added support for dynamic and conditional inheritance ({% extends some_var %} and {% extends standalone ? "minimum" : "base" %})
868 * added a grammar sub-framework to ease the creation of custom tags
869 * fixed the for tag for large arrays (some loop variables are now only available for arrays and objects that implement the Countable interface)
870 * removed the Twig_Resource::resolveMissingFilter() method
871 * fixed the filter tag which did not apply filtering to included files
872 * added a bunch of unit tests
873 * added a bunch of phpdoc
874 * added a sandbox tag in the sandbox extension
875 * changed the date filter to support any date format supported by DateTime
876 * added strict_variable setting to throw an exception when an invalid variable is used in a template (disabled by default)
877 * added the lexer, parser, and compiler as arguments to the Twig_Environment constructor
878 * changed the cache option to only accepts an explicit path to a cache directory or false
879 * added a way to add token parsers, filters, and visitors without creating an extension
880 * added three interfaces: Twig_NodeInterface, Twig_TokenParserInterface, and Twig_FilterInterface
881 * changed the generated code to match the new coding standards
882 * fixed sandbox mode (__toString() method check was not enforced if called implicitly from a simple statement like {{ article }})
883 * added an exception when a child template has a non-empty body (as it is always ignored when rendering)
887 * fixed variables defined outside a loop and for which the value changes in a for loop
888 * fixed the test suite for PHP 5.2 and older versions of PHPUnit
889 * added support for __call() in expression resolution
890 * fixed node visiting for macros (macros are now visited by visitors as any other node)
891 * fixed nested block definitions with a parent call (rarely useful but nonetheless supported now)
892 * added the cycle filter
893 * fixed the Lexer when mbstring.func_overload is used with an mbstring.internal_encoding different from ASCII
894 * added a long-syntax for the set tag ({% set foo %}...{% endset %})
895 * unit tests are now powered by PHPUnit
896 * added support for gettext via the `i18n` extension
897 * fixed twig_capitalize_string_filter() and fixed twig_length_filter() when used with UTF-8 values
898 * added a more useful exception if an if tag is not closed properly
899 * added support for escaping strategy in the autoescape tag
900 * fixed lexer when a template has a big chunk of text between/in a block
904 As for any new release, don't forget to remove all cached templates after
907 If you have defined custom filters, you MUST upgrade them for this release. To
908 upgrade, replace "array" with "new Twig_Filter_Function", and replace the
909 environment constant by the "needs_environment" option:
912 'even' => array('twig_is_even_filter', false),
913 'escape' => array('twig_escape_filter', true),
916 'even' => new Twig_Filter_Function('twig_is_even_filter'),
917 'escape' => new Twig_Filter_Function('twig_escape_filter', array('needs_environment' => true)),
919 If you have created NodeTransformer classes, you will need to upgrade them to
920 the new interface (please note that the interface is not yet considered
923 * fixed list nodes that did not extend the Twig_NodeListInterface
924 * added the "without loop" option to the for tag (it disables the generation of the loop variable)
925 * refactored node transformers to node visitors
926 * fixed automatic-escaping for blocks
927 * added a way to specify variables to pass to an included template
928 * changed the automatic-escaping rules to be more sensible and more configurable in custom filters (the documentation lists all the rules)
929 * improved the filter system to allow object methods to be used as filters
930 * changed the Array and String loaders to actually make use of the cache mechanism
931 * included the default filter function definitions in the extension class files directly (Core, Escaper)
932 * added the // operator (like the floor() PHP function)
933 * added the .. operator (as a syntactic sugar for the range filter when the step is 1)
934 * added the in operator (as a syntactic sugar for the in filter)
935 * added the following filters in the Core extension: in, range
936 * added support for arrays (same behavior as in PHP, a mix between lists and dictionaries, arrays and hashes)
937 * enhanced some error messages to provide better feedback in case of parsing errors
941 If you have custom loaders, you MUST upgrade them for this release: The
942 Twig_Loader base class has been removed, and the Twig_LoaderInterface has also
943 been changed (see the source code for more information or the documentation).
945 * added support for DateTime instances for the date filter
946 * fixed loop.last when the array only has one item
947 * made it possible to insert newlines in tag and variable blocks
948 * fixed a bug when a literal '\n' were present in a template text
949 * fixed bug when the filename of a template contains */
954 This release is NOT backward compatible with the previous releases.
956 The loaders do not take the cache and autoReload arguments anymore. Instead,
957 the Twig_Environment class has two new options: cache and auto_reload.
958 Upgrading your code means changing this kind of code:
960 $loader = new Twig_Loader_Filesystem('/path/to/templates', '/path/to/compilation_cache', true);
961 $twig = new Twig_Environment($loader);
963 to something like this:
965 $loader = new Twig_Loader_Filesystem('/path/to/templates');
966 $twig = new Twig_Environment($loader, array(
967 'cache' => '/path/to/compilation_cache',
968 'auto_reload' => true,
971 * deprecated the "items" filter as it is not needed anymore
972 * made cache and auto_reload options of Twig_Environment instead of arguments of Twig_Loader
973 * optimized template loading speed
974 * removed output when an error occurs in a template and render() is used
975 * made major speed improvements for loops (up to 300% on even the smallest loops)
976 * added properties as part of the sandbox mode
977 * added public properties support (obj.item can now be the item property on the obj object)
978 * extended set tag to support expression as value ({% set foo as 'foo' ~ 'bar' %} )
979 * fixed bug when \ was used in HTML
983 * made some speed optimizations
984 * changed the cache extension to .php
985 * added a js escaping strategy
986 * added support for short block tag
987 * changed the filter tag to allow chained filters
988 * made lexer more flexible as you can now change the default delimiters
990 * changed default directory permission when cache dir does not exist (more secure)
991 * added macro support
992 * changed filters first optional argument to be a Twig_Environment instance instead of a Twig_Template instance
993 * made Twig_Autoloader::autoload() a static method
994 * avoid writing template file if an error occurs
995 * added $ escaping when outputting raw strings
996 * enhanced some error messages to ease debugging
997 * fixed empty cache files when the template contains an error
1001 * fixed a bug in PHP 5.2.6
1002 * fixed numbers with one than one decimal
1003 * added support for method calls with arguments ({{ foo.bar('a', 43) }})
1004 * made small speed optimizations
1005 * made minor tweaks to allow better extensibility and flexibility
1007 * 0.9.0 (2009-10-12)