CHANGELOG 45 KB

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