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